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