Ateneo
Anmelden

← Ateneo

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

OpenAPI-Spezifikation →