Ateneo
Entrar

← Ateneo

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

Especificación OpenAPI →