API di Ateneo
Collega il tuo gestionale (biglietteria, soci, scuola o eventi) agli eventi e alle prenotazioni della tua organizzazione: leggi eventi e capienza, crea eventi, invia liste di invitati e preprenotazioni, e ricevi notifiche via webhook.
URL base
https://ateneo.app/api/v1
Autenticazione
Ogni organizzazione genera le sue chiavi API dal pannello di amministrazione (sezione API, nei piani a pagamento), ognuna con i suoi permessi. Invia la chiave nell'intestazione di ogni richiesta:
Authorization: Bearer atn_live_…
Se il tuo gestionale usa OAuth2, crea un client nella stessa sezione e scambia il suo client_id e client_secret con un token di un'ora su /oauth/token (client credentials). Il token si invia come la chiave.
Endpoint
- POST
/oauth/tokenScambia client_id e client_secret con un token di un'ora - GET
/eventsEventi della tua organizzazione - POST
/eventsCrea un evento su una pianta della tua organizzazione - GET
/events/{id}Un evento con le sue repliche - GET
/events/{id}/availabilityCapienza della pianta e posti occupati in ogni replica - PUT
/events/{id}/rosterSostituisce la lista degli invitati (inviata dal tuo gestionale) - POST
/events/{id}/reservationsPreprenota posti a nome di qualcuno (dal tuo gestionale) - GET
/reservations?email=…Prenotazioni di una persona, per indirizzo email - GET
/webhooksWebhook della tua organizzazione - POST
/webhooksRegistra un webhook (il segreto viene mostrato una sola volta) - DELETE
/webhooks/{id}Elimina un webhook - POST
/webhooks/{id}/testInvia una notifica di prova firmata
Esempio
curl -H "Authorization: Bearer atn_live_…" \ https://ateneo.app/api/v1/events
Webhook
Registrali nel pannello o tramite l'API per ricevere notifiche firmate di questi eventi. Verifica l'header X-Ateneo-Signature (formato t=…,v1=HMAC-SHA256 del segreto su «timestamp.corpo»).
reservation.created reservation.cancelled pass.soldout event.published