Ateneo
Accedi

← Ateneo

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

Specifica OpenAPI →