API d'Ateneo
Connectez votre logiciel de gestion (billetterie, adhérents, scolaire ou événements) aux événements et réservations de votre organisation : lisez les événements et la jauge, créez des événements, envoyez des listes d'invités et des préréservations, et recevez des notifications par webhook.
URL de base
https://ateneo.app/api/v1
Authentification
Chaque organisation génère ses clés API dans le panneau d'administration (section API, sur les forfaits payants), chacune avec ses propres droits. Envoyez la clé dans l'en-tête de chaque requête :
Authorization: Bearer atn_live_…
Si votre logiciel utilise OAuth2, créez un client dans la même section et échangez son client_id et son client_secret contre un jeton d'une heure sur /oauth/token (client credentials). Le jeton s'envoie comme la clé.
Endpoints
- POST
/oauth/tokenÉchange client_id et client_secret contre un jeton d'une heure - GET
/eventsÉvénements de votre organisation - POST
/eventsCrée un événement sur un plan de votre organisation - GET
/events/{id}Un événement et ses séances - GET
/events/{id}/availabilityJauge du plan et places occupées à chaque séance - PUT
/events/{id}/rosterRemplace la liste d'invités (envoyée par votre logiciel de gestion) - POST
/events/{id}/reservationsPréréserve des places au nom d'une personne (depuis votre logiciel de gestion) - GET
/reservations?email=…Réservations d'une personne, par son adresse e-mail - GET
/webhooksWebhooks de votre organisation - POST
/webhooksEnregistre un webhook (son secret n'est affiché qu'une fois) - DELETE
/webhooks/{id}Supprime un webhook - POST
/webhooks/{id}/testEnvoie une notification de test signée
Exemple
curl -H "Authorization: Bearer atn_live_…" \ https://ateneo.app/api/v1/events
Webhooks
Enregistrez-les dans le panneau ou par l'API pour recevoir des notifications signées de ces événements. Vérifiez l'en-tête X-Ateneo-Signature (format t=…,v1=HMAC-SHA256 du secret sur « timestamp.corps »).
reservation.created reservation.cancelled pass.soldout event.published