API REST v1

API para desarrolladores

Integra tu aplicación con Celebrae. Shops, experiencias, reservas y webhooks.

Gestionar credenciales Plan Enterprise Ver documentación

¿Qué hace la API?

La API REST v1 de Celebrae permite integrar tu aplicación, sistema de reservas o marketplace con la plataforma de experiencias grupales. Es una API server-to-server: las peticiones se hacen desde tu backend con credenciales seguras, nunca desde el navegador.

Qué puedes hacer:

Shops (locales) — Listar y ver detalle de los negocios a los que tienes acceso.
Experiencias — Obtener el catálogo de experiencias (tours, clases, eventos) con precios, duración y extras.
Extras — Consultar add-ons de cada experiencia (fotos, transporte, etc.).
Reservas (bookings) — Crear reservas desde tu sistema y listar/filtrar las existentes por fecha, estado o shop.
Webhooks — Recibir notificaciones en tiempo real cuando se crea, actualiza, completa o cancela una reserva.
Deliveries — Consultar el estado de los envíos de webhooks (éxito, fallo, reintentos).

Para quién es:

Integradores, OTAs (Online Travel Agencies), marketplaces, sistemas de gestión de reservas (PMS), plataformas de venta de actividades y cualquier aplicación que necesite sincronizar reservas con Celebrae sin usar el checkout interno.

Reservas vía API:

Las reservas creadas por API tienen payment_source: external. El pago se gestiona fuera de Celebrae (tu checkout, Stripe, etc.). Celebrae registra la reserva, genera QR para validación en punto de venta y envía el webhook booking.created para que sincronices tu sistema.

Autenticación y scopes:

Cada API client tiene client_id y secret. Se autentica con Authorization: Bearer client_id:secret. Los scopes (shops:read, bookings:write, etc.) definen qué puede hacer cada cliente. Un cliente puede tener acceso a varios shops (multi-tenant).

Quick start

1. Autenticación

Usa client_id:secret en el header Authorization:

curl -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  https://www.celebrae.com/api/v1/shops

2. Listar reservas

curl -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  "https://www.celebrae.com/api/v1/bookings?limit=10"

3. Crear una reserva

curl -X POST \
  -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-key-123" \
  -d '{
    "kit_id": "uuid-experiencia",
    "shop_id": "uuid-shop",
    "booking_date": "2024-06-15",
    "booking_time": "10:00",
    "number_of_people": 2,
    "buyer_name": "Juan Pérez",
    "buyer_email": "juan@ejemplo.com"
  }' \
  https://www.celebrae.com/api/v1/bookings

Recursos disponibles

Credenciales

Crea y gestiona tus API clients desde el panel de seller. Cada cliente puede tener acceso a uno o varios locales.

Ir al panel

Webhooks

Recibe notificaciones en tiempo real cuando se crea una reserva. Registra tu URL y verifica la firma HMAC.

Configurar webhooks

Documentación completa

Referencia de endpoints, autenticación, webhooks y ejemplos de código.

Ver documentación Colección Postman OpenAPI Spec

¿Qué hace la API?

Qué puedes hacer:

Shops (locales) — Listar y ver detalle de los negocios a los que tienes acceso.
Experiencias — Obtener el catálogo de experiencias (tours, clases, eventos) con precios, duración y extras.
Extras — Consultar add-ons de cada experiencia (fotos, transporte, etc.).
Reservas (bookings) — Crear reservas desde tu sistema y listar/filtrar las existentes por fecha, estado o shop.
Webhooks — Recibir notificaciones en tiempo real cuando se crea, actualiza, completa o cancela una reserva.
Deliveries — Consultar el estado de los envíos de webhooks (éxito, fallo, reintentos).

Para quién es:

Reservas vía API:

Autenticación y scopes:

Quick start

1. Autenticación

Usa client_id:secret en el header Authorization:

curl -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  https://www.celebrae.com/api/v1/shops

2. Listar reservas

curl -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  "https://www.celebrae.com/api/v1/bookings?limit=10"

3. Crear una reserva

curl -X POST \
  -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-key-123" \
  -d '{
    "kit_id": "uuid-experiencia",
    "shop_id": "uuid-shop",
    "booking_date": "2024-06-15",
    "booking_time": "10:00",
    "number_of_people": 2,
    "buyer_name": "Juan Pérez",
    "buyer_email": "juan@ejemplo.com"
  }' \
  https://www.celebrae.com/api/v1/bookings

¿Qué hace la API?

Qué puedes hacer:

Shops (locales) — Listar y ver detalle de los negocios a los que tienes acceso.
Experiencias — Obtener el catálogo de experiencias (tours, clases, eventos) con precios, duración y extras.
Extras — Consultar add-ons de cada experiencia (fotos, transporte, etc.).
Reservas (bookings) — Crear reservas desde tu sistema y listar/filtrar las existentes por fecha, estado o shop.
Webhooks — Recibir notificaciones en tiempo real cuando se crea, actualiza, completa o cancela una reserva.
Deliveries — Consultar el estado de los envíos de webhooks (éxito, fallo, reintentos).

Para quién es:

Reservas vía API:

Autenticación y scopes:

Quick start

1. Autenticación

Usa client_id:secret en el header Authorization:

curl -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  https://www.celebrae.com/api/v1/shops

2. Listar reservas

curl -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  "https://www.celebrae.com/api/v1/bookings?limit=10"

3. Crear una reserva

curl -X POST \
  -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-key-123" \
  -d '{
    "kit_id": "uuid-experiencia",
    "shop_id": "uuid-shop",
    "booking_date": "2024-06-15",
    "booking_time": "10:00",
    "number_of_people": 2,
    "buyer_name": "Juan Pérez",
    "buyer_email": "juan@ejemplo.com"
  }' \
  https://www.celebrae.com/api/v1/bookings

¿Qué hace la API?

Qué puedes hacer:

Shops (locales) — Listar y ver detalle de los negocios a los que tienes acceso.
Experiencias — Obtener el catálogo de experiencias (tours, clases, eventos) con precios, duración y extras.
Extras — Consultar add-ons de cada experiencia (fotos, transporte, etc.).
Reservas (bookings) — Crear reservas desde tu sistema y listar/filtrar las existentes por fecha, estado o shop.
Webhooks — Recibir notificaciones en tiempo real cuando se crea, actualiza, completa o cancela una reserva.
Deliveries — Consultar el estado de los envíos de webhooks (éxito, fallo, reintentos).

Para quién es:

Reservas vía API:

Autenticación y scopes:

Quick start

1. Autenticación

Usa client_id:secret en el header Authorization:

curl -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  https://www.celebrae.com/api/v1/shops

2. Listar reservas

curl -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  "https://www.celebrae.com/api/v1/bookings?limit=10"

3. Crear una reserva

curl -X POST \
  -H "Authorization: Bearer TU_CLIENT_ID:TU_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-key-123" \
  -d '{
    "kit_id": "uuid-experiencia",
    "shop_id": "uuid-shop",
    "booking_date": "2024-06-15",
    "booking_time": "10:00",
    "number_of_people": 2,
    "buyer_name": "Juan Pérez",
    "buyer_email": "juan@ejemplo.com"
  }' \
  https://www.celebrae.com/api/v1/bookings