API para desenvolvedores
A API para desenvolvedores do TourPro permite que seus próprios scripts e integrações leiam seus dados. O acesso funciona por meio de tokens de acesso pessoal: cada token age em seu nome e só consegue visualizar as turnês que você pode ver.
A Fase 1 é somente leitura: você pode consultar sua identidade, suas turnês e os eventos da agenda.
Criar um token
Abra seu perfil
No aplicativo web, abra seu Perfil e escolha a aba Desenvolvedor.
Crie o token
Clique em Criar token, dê um nome a ele (por exemplo, o script ou serviço que vai utilizá-lo) e confirme.
Copie agora
O TourPro exibe o token apenas uma vez. Copie-o e guarde-o como uma senha. Se perdê-lo, revogue o token e crie um novo.
Chamar a API
Envie o token como credencial Bearer:
Authorization: Bearer tourpro_...| Endpoint | Retorna |
|---|---|
GET /api/v1/me | Seu ID de usuário, nome e e-mail |
GET /api/v1/tours | As turnês que você pode acessar |
GET /api/v1/tours/:tourId/events | Eventos da agenda de uma turnê, filtrados conforme suas permissões e regras de visibilidade |
A URL base é o host da API (por exemplo, https://api.tourpro.app), e não o aplicativo web.
curl https://api.tourpro.app/api/v1/tours \
-H "Authorization: Bearer tourpro_..."A API possui limite de 120 requisições por minuto por token. Acima desse limite, você recebe uma resposta 429 com cabeçalhos RateLimit descrevendo a janela atual.
Revogar um token
Na aba Desenvolvedor, clique em Revogar ao lado do token e confirme. A revogação é imediata e permanente: crie um novo token caso precise substituí-lo.
O que um token pode visualizar
Um token nunca vê mais do que você:
- Turnês: apenas as turnês que você criou ou das quais faz parte.
- Eventos: apenas os eventos visíveis para o seu papel e para o seu período ativo naquela turnê, e somente quando você tem permissão para visualizar a agenda.
- Tudo é somente leitura. Nada na API pode alterar seus dados.
Sessões de login do aplicativo não funcionam na API. Os endpoints v1 aceitam apenas tokens tourpro_, portanto uma sessão de navegador roubada não pode ser reutilizada contra eles.