Ateneo
Entrar

← Ateneo

API do Ateneo

Liga o teu programa de gestão (de bilheteira, de sócios, escolar ou de eventos) aos eventos e reservas da tua organização: lê eventos e lotação, cria eventos, envia listas de convidados e pré-reservas, e recebe avisos por webhook.

URL base

https://ateneo.app/api/v1

Autenticação

Cada organização gera as suas chaves de API no painel de administração (secção API, em planos pagos), cada uma com as suas permissões. Envia a chave no cabeçalho de cada pedido:

Authorization: Bearer atn_live_…

Se o teu programa usa OAuth2, cria um cliente na mesma secção e troca o seu client_id e client_secret por um token de uma hora em /oauth/token (client credentials). O token envia-se tal como a chave.

Endpoints

  • POST/oauth/tokenTroca client_id e client_secret por um token de uma hora
  • GET/eventsEventos da tua organização
  • POST/eventsCria um evento sobre uma planta da tua organização
  • GET/events/{id}Um evento e as suas sessões
  • GET/events/{id}/availabilityLotação da planta e lugares ocupados em cada sessão
  • PUT/events/{id}/rosterSubstitui a lista de convidados (enviada pelo teu programa de gestão)
  • POST/events/{id}/reservationsPré-reserva lugares em nome de alguém (a partir do teu programa de gestão)
  • GET/reservations?email=…Reservas de uma pessoa, pelo seu email
  • GET/webhooksWebhooks da tua organização
  • POST/webhooksRegista um webhook (o segredo só se mostra uma vez)
  • DELETE/webhooks/{id}Apaga um webhook
  • POST/webhooks/{id}/testEnvia um aviso de teste assinado

Exemplo

curl -H "Authorization: Bearer atn_live_…" \
  https://ateneo.app/api/v1/events

Webhooks

Regista-os no painel ou pela API para receber avisos assinados destes eventos. Verifica o cabeçalho X-Ateneo-Signature (formato t=…,v1=HMAC-SHA256 do segredo sobre «timestamp.corpo»).

reservation.created
reservation.cancelled
pass.soldout
event.published

Especificação OpenAPI →