API de Ateneo
Conecta tu programa de gestión (de taquilla, de socios, escolar o de eventos) con los eventos y las reservas de tu organización: lee eventos y aforo, crea eventos, envía listas de invitados y prerreservas, y recibe avisos por webhook.
URL base
https://ateneo.app/api/v1
Autenticación
Cada organización genera sus claves de API en el panel de administración (sección API, en planes de pago), cada una con sus permisos. Envía la clave en la cabecera de cada petición:
Authorization: Bearer atn_live_…
Si tu programa usa OAuth2, crea un cliente en la misma sección y cambia su client_id y client_secret por un token de una hora en /oauth/token (client credentials). El token se envía igual que la clave.
Endpoints
- POST
/oauth/tokenCambia client_id y client_secret por un token de una hora - GET
/eventsEventos de tu organización - POST
/eventsCrea un evento sobre un plano de tu organización - GET
/events/{id}Un evento con sus pases - GET
/events/{id}/availabilityAforo del plano y plazas ocupadas en cada pase - PUT
/events/{id}/rosterSustituye la lista de invitados (la envía tu programa de gestión) - POST
/events/{id}/reservationsPrerreserva butacas a nombre de alguien (desde tu programa de gestión) - GET
/reservations?email=…Reservas de una persona, por su correo - GET
/webhooksWebhooks de tu organización - POST
/webhooksDa de alta un webhook (su secreto se muestra una sola vez) - DELETE
/webhooks/{id}Borra un webhook - POST
/webhooks/{id}/testEnvía un aviso de prueba firmado
Ejemplo
curl -H "Authorization: Bearer atn_live_…" \ https://ateneo.app/api/v1/events
Webhooks
Dalos de alta en el panel o por la API para recibir avisos firmados de estos eventos. Verifica la cabecera X-Ateneo-Signature (formato t=…,v1=HMAC-SHA256 del secreto sobre «timestamp.cuerpo»).
reservation.created reservation.cancelled pass.soldout event.published