Ateneo
Se connecter

← Ateneo

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

Spécification OpenAPI →