Ateneo-API
Verbinde deine Verwaltungssoftware (Kasse, Mitglieder, Schule oder Veranstaltungen) mit den Veranstaltungen und Reservierungen deiner Organisation: Lies Veranstaltungen und Kapazität aus, lege Veranstaltungen an, übermittle Gästelisten und Vorabreservierungen und empfange Benachrichtigungen per Webhook.
Basis-URL
https://ateneo.app/api/v1
Authentifizierung
Jede Organisation erzeugt ihre API-Schlüssel im Verwaltungsbereich (Abschnitt API, in kostenpflichtigen Tarifen), jeden mit eigenen Berechtigungen. Sende den Schlüssel im Header jeder Anfrage:
Authorization: Bearer atn_live_…
Nutzt deine Software OAuth2, lege im selben Abschnitt einen Client an und tausche dessen client_id und client_secret unter /oauth/token gegen ein Token, das eine Stunde gilt (Client Credentials). Das Token wird wie der Schlüssel gesendet.
Endpoints
- POST
/oauth/tokenTauscht client_id und client_secret gegen ein Token, das eine Stunde gilt - GET
/eventsVeranstaltungen deiner Organisation - POST
/eventsLegt eine Veranstaltung auf einem Saalplan deiner Organisation an - GET
/events/{id}Eine Veranstaltung mit ihren Vorstellungen - GET
/events/{id}/availabilityKapazität des Saalplans und belegte Plätze je Vorstellung - PUT
/events/{id}/rosterErsetzt die Gästeliste (übermittelt von deiner Verwaltungssoftware) - POST
/events/{id}/reservationsReserviert Plätze vorab auf einen Namen (aus deiner Verwaltungssoftware) - GET
/reservations?email=…Reservierungen einer Person, nach E-Mail-Adresse - GET
/webhooksWebhooks deiner Organisation - POST
/webhooksRegistriert einen Webhook (sein Secret wird nur einmal angezeigt) - DELETE
/webhooks/{id}Löscht einen Webhook - POST
/webhooks/{id}/testSendet eine signierte Testbenachrichtigung
Beispiel
curl -H "Authorization: Bearer atn_live_…" \ https://ateneo.app/api/v1/events
Webhooks
Registriere sie im Panel oder über die API, um signierte Benachrichtigungen zu diesen Ereignissen zu empfangen. Prüfe den Header X-Ateneo-Signature (Format t=…,v1=HMAC-SHA256 des Secrets über „timestamp.body“).
reservation.created reservation.cancelled pass.soldout event.published