Skip to Content

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_...
EndpointRetorna
GET /api/v1/meSeu ID de usuário, nome e e-mail
GET /api/v1/toursAs turnês que você pode acessar
GET /api/v1/tours/:tourId/eventsEventos 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.

Last updated on