Para que serve
A API pública de eventos permite que sistemas externos (sites parceiros, agregadores, integrações de marketing) consultem, em tempo real, os eventos, sessões e disponibilidade de ingressos publicados na sua página de vendas. Com ela, um parceiro pode montar sua própria vitrine de eventos, exibir badges como "últimos ingressos" ou "esgotado", e direcionar o público de volta para o link de compra oficial da TriRS.
Toda venda originada de um link retornado pela API é automaticamente atribuída à integração que fez a consulta, sem que o parceiro precise fazer nada além de usar o link como veio na resposta. Isso permite acompanhar, no seu painel, quanto cada integração está vendendo.
Como conseguir a chave de acesso
A chave de API é gerada diretamente pelo painel do produtor, na tela de integrações:
- Acesse o menu de Integrações no painel do produtor.
- Localize a opção de geração de token para a API pública de eventos.
- Gere a chave — ela é exibida uma única vez, então copie e guarde em local seguro.
- Envie essa chave para o time técnico do parceiro que vai consumir a API.
Se você gerar uma nova chave, a chave anterior deixa de funcionar imediatamente. Gere uma nova apenas quando realmente precisar trocar, por exemplo, se a chave antiga foi exposta acidentalmente.
O que a API retorna
Entre outras informações, a API pública de eventos disponibiliza:
- Lista de eventos ativos e publicados, com paginação.
- Detalhes de um evento específico (descrição, imagem, local, sessões).
- Disponibilidade de ingressos por sessão, indicando se está esgotado (sem expor a quantidade exata em estoque).
- Selos de destaque, como "últimos ingressos" ou "esgotado", para exibição visual no site do parceiro.
Eventos marcados como privados não aparecem para consultas externas, mesmo que o identificador do evento seja conhecido.
Limites de uso
Para preservar a estabilidade do serviço, a API aplica um limite de requisições por minuto por chave. Se o parceiro fizer chamadas em excesso, receberá uma resposta informando que o limite foi atingido — nesse caso, basta aguardar um minuto e tentar novamente.
Documentação técnica completa
A referência completa de endpoints, parâmetros aceitos, formato de resposta e exemplos de chamada fica disponível em um documento próprio, fornecido pelo suporte ou pelo painel ao solicitar a integração. Esse documento é indicado para a equipe técnica que vai efetivamente implementar a integração — se você é o produtor e só quer disponibilizar o acesso, basta gerar a chave e repassar o documento de referência recebido do suporte.
Em caso de dúvida sobre como usar a chave ou sobre algum comportamento da API, fale com o suporte da TriRS informando o nome da integração.