Skip to main content

API de reservas: recibe reservas en tu propio sitio web

Una API JSON pequeña y segura para tu camping: consulta tus tipos de parcela, extras, disponibilidad y precios, y crea reservas. Todo lo que viene después se gestiona en tu panel de Campiamo.

Última actualización: 9 de noviembre de 2026

La API de reservas permite que tu propio sitio web introduzca reservas en Campiamo. Hace dos cosas: te dice qué se puede reservar (tipos de parcela, extras, disponibilidad y precios) y crea reservas. Modificar, cancelar, cobrar saldos y hacer el check-in de los huéspedes se hace en tu panel de Campiamo, igual que con cualquier otra reserva.

La API de reservas forma parte del plan Growth y superiores.

Si lo único que quieres es un formulario de reserva en tu propio sitio web, no necesitas la API: el widget de reservas lo hace con una línea de código. La API es para cuando quieres construir tú mismo el formulario de reserva.

Antes de empezar

  1. En tu panel, ve a Ajustes → API.
  2. Elige Crear clave, ponle un nombre que vayas a reconocer («Sitio web», «Formulario de reserva») y confirma con tu contraseña.
  3. Copia la clave. Se muestra una sola vez. Solo guardamos una huella de ella, así que nadie, ni siquiera nosotros, puede volver a mostrártela. Si la pierdes, revócala y crea otra.

Una clave pertenece a un solo camping. Puedes tener hasta cinco, y puedes revocar cualquiera en cualquier momento; una clave revocada deja de funcionar al instante.

Guarda la clave en tu servidor

La clave es una contraseña para crear reservas en tu camping. Trátala como tal:

  • Llama a la API solo desde tu servidor, nunca desde JavaScript en una página web ni desde una app móvil, donde cualquiera puede leerla. La API rechaza las llamadas hechas desde navegadores en otros sitios.
  • No la pongas en una dirección web, en un correo ni en un repositorio de código público.
  • Si conoces la dirección desde la que llama tu servidor, restringe la clave a ella en Direcciones IP permitidas.
  • Si crees que una clave se ha filtrado, revócala. Recibes un correo cada vez que se crea o se revoca una clave en tu cuenta.

Hacer una petición

La dirección base es:

https://campiamo.com/api/v1

Envía tu clave en la cabecera Authorization en cada petición, por HTTPS:

curl https://campiamo.com/api/v1/campsite \
  -H "Authorization: Bearer cmp_live_YOUR_KEY" \
  -H "Accept: application/json"

Las peticiones y las respuestas son JSON. Las fechas son YYYY-MM-DD, y check_out es la mañana en que se va el huésped. Los precios son números en la moneda de tu camping.

Qué se puede reservar

Tu camping

GET /campsite devuelve lo que un formulario de reserva necesita saber sobre tu camping.

{
  "name": "Meadow Fields Campsite",
  "currency": "GBP",
  "timezone": "Europe/London",
  "language": "en",
  "check_in_time": "14:00",
  "check_out_time": "11:00",
  "open_season": "1 March to 31 October",
  "guest_fields": { "phone_required": false },
  "age_bands": { "enabled": true, "child_min": 2, "child_max": 15, "adult_from": 16, "infants": true, "infant_under": 2, "infants_take_space": false },
  "booking_questions": [],
  "club_memberships": [],
  "discount_codes": false,
  "gift_vouchers": false,
  "payment": {
    "online_payment": true,
    "provider": "Stripe",
    "terms": "A deposit of 25% is paid at checkout; the balance is due 14 days before arrival."
  }
}

booking_questions son tus campos de reserva personalizados. Devuelve las respuestas en answers cuando crees una reserva, indexadas por el id de cada pregunta.

Tipos de parcela

GET /pitch-types lista los tipos de parcela y de alojamiento que los huéspedes pueden reservar.

{
  "pitch_types": [
    {
      "id": "01kwz3mjx2abcdef0123456789",
      "name": "Grass pitch with electric",
      "type": "pitch",
      "description": "Level grass pitches with a 16A hook-up.",
      "photos": ["https://campiamo.com/img/01kx.../1280"],
      "base_price": 28.0,
      "pricing": "per_night",
      "included_adults": 2,
      "included_children": 0,
      "extra_adult_price": 5.0,
      "extra_child_price": 3.0,
      "max_persons": 6,
      "adults_only": false,
      "dogs_allowed": true,
      "max_dogs": 2,
      "extra_dog_price": 2.0,
      "min_nights": 1,
      "max_nights": null,
      "units": 12
    }
  ]
}

base_price es el precio de partida. Las temporadas, las estancias mínimas y el tamaño del grupo cambian lo que cuesta una estancia, así que toma siempre el precio para fechas reales de la disponibilidad o de un presupuesto.

Extras

GET /extras lista los extras que un huésped puede añadir. pitch_type_ids está vacío cuando un extra se ofrece con todos los tipos de parcela.

{
  "extras": [
    {
      "id": "01kx0a...",
      "name": "Firewood bundle",
      "description": "A net of seasoned logs.",
      "price": 8.0,
      "child_price": null,
      "price_type": "fixed",
      "max_quantity": 5,
      "choice_label": null,
      "choices": [],
      "pitch_type_ids": []
    }
  ]
}

Disponibilidad

GET /availability responde a «¿qué hay libre para estas fechas y este grupo, y cuánto cuesta?».

Parámetro
check_in obligatorio Fecha de llegada
check_out obligatorio Fecha de salida
adults opcional Por defecto 2
children opcional Por defecto 0
infants opcional Por defecto 0
dogs opcional Por defecto 0
curl "https://campiamo.com/api/v1/availability?check_in=2027-06-12&check_out=2027-06-15&adults=2&children=1" \
  -H "Authorization: Bearer cmp_live_YOUR_KEY"
{
  "check_in": "2027-06-12",
  "check_out": "2027-06-15",
  "nights": 3,
  "party": { "adults": 2, "children": 1, "infants": 0, "dogs": 0 },
  "currency": "GBP",
  "available": [
    {
      "pitch_type_id": "01kwz3mjx2abcdef0123456789",
      "name": "Grass pitch with electric",
      "units_free": 4,
      "max_persons": 6,
      "dogs_allowed": true,
      "total_price": 93.0,
      "due_now": 23.25
    }
  ],
  "unavailable": [
    { "pitch_type_id": "01kwz3mjx9...", "name": "Bell tent", "reason": "minimum_stay", "detail": "minimum stay 4 nights for those dates" }
  ]
}

due_now es lo que el huésped pagaría al reservar según tus reglas de señal. El reason de un tipo de parcela no disponible es uno de closed, adults_only, too_many_people, no_dogs, too_many_dogs, maximum_stay, not_offered, minimum_stay, fully_booked o no_price.

Un presupuesto

POST /quotes calcula el precio de un tipo de parcela con extras y códigos, sin reservar nada. Admite los mismos campos de estancia que una reserva.

curl https://campiamo.com/api/v1/quotes \
  -H "Authorization: Bearer cmp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pitch_type_id": "01kwz3mjx2abcdef0123456789",
    "check_in": "2027-06-12",
    "check_out": "2027-06-15",
    "adults": 2,
    "children": 1,
    "extras": [{ "extra_id": "01kx0a...", "quantity": 2 }]
  }'
{
  "pitch_type_id": "01kwz3mjx2abcdef0123456789",
  "name": "Grass pitch with electric",
  "check_in": "2027-06-12",
  "check_out": "2027-06-15",
  "nights": 3,
  "party": { "adults": 2, "children": 1, "infants": 0, "dogs": 0 },
  "currency": "GBP",
  "accommodation_total": 84.0,
  "guest_extras": [{ "name": "Extra child", "total": 9.0 }],
  "extras": [{ "extra_id": "01kx0a...", "name": "Firewood bundle", "quantity": 2, "choice": null, "total": 16.0 }],
  "club_membership": null,
  "tourist_tax": null,
  "discount": null,
  "voucher": null,
  "total": 109.0,
  "due_now": 27.25
}

guest_extras son los cargos por personas o perros que superan los incluidos en el precio de la parcela. tourist_tax se rellena cuando tu camping cobra una tasa turística; cuando se cobra con la reserva ya está dentro de total.

Crear una reserva

POST /bookings crea una reserva. Se comprueba con las mismas reglas que tu widget de reservas: la temporada, la disponibilidad, las estancias mínimas, el tamaño del grupo, los perros, las preguntas obligatorias y los extras. Si un huésped no pudiera hacer la reserva en tu página de reservas, la API tampoco la hará.

Campo
pitch_type_id obligatorio De los tipos de parcela o de la disponibilidad
check_in, check_out obligatorio Hoy o más adelante
adults obligatorio Al menos 1
children, infants, dogs opcional Por defecto 0
child_ages obligatorio si hay niños Una edad por niño, p. ej. [4, 9]
guest.name, guest.email obligatorio
guest.phone opcional Obligatorio si tu camping exige un número de teléfono
guest.address opcional line_1, line_2, city, county, postcode
extras opcional [{ "extra_id": "...", "quantity": 1, "choice": "..." }]
answers opcional Respuestas a tus preguntas de reserva, indexadas por el id de la pregunta
discount_code, voucher_code opcional
notes opcional Hasta 1000 caracteres
payment obligatorio checkout u on_arrival, ver más abajo
send_guest_emails opcional Solo con on_arrival. Por defecto true
price opcional Solo con on_arrival. Tu propio total para esta reserva, en lugar del calculado

El huésped paga online: "payment": "checkout"

Úsalo cuando un huésped está reservando en tu sitio web. Recibes un enlace a una página de pago segura alojada por tu proveedor de pagos. Envía a ella el navegador del huésped.

curl https://campiamo.com/api/v1/bookings \
  -H "Authorization: Bearer cmp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7f1c2c0e-2f0b-4c59-9a3b-6f0d1f5b8a11" \
  -d '{
    "pitch_type_id": "01kwz3mjx2abcdef0123456789",
    "check_in": "2027-06-12",
    "check_out": "2027-06-15",
    "adults": 2,
    "children": 1,
    "child_ages": [9],
    "guest": { "name": "Sam Carter", "email": "sam@example.com", "phone": "07700 900123" },
    "payment": "checkout"
  }'
{
  "status": "payment_required",
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_...",
  "expires_at": "2026-11-10T10:42:00+00:00",
  "pitch_type_id": "01kwz3mjx2abcdef0123456789",
  "check_in": "2027-06-12",
  "check_out": "2027-06-15",
  "nights": 3,
  "currency": "GBP",
  "total": 93.0,
  "due_now": 23.25
}

La reserva se crea cuando el huésped paga. La parcela queda retenida mientras está en la página de pago. Una vez que paga, la reserva aparece en tu panel, el huésped llega a una página de confirmación y recibe tu correo de confirmación con su referencia de reserva. Si se va sin pagar, no se reserva nada y la parcela se libera.

Para esto tu camping tiene que aceptar pagos online (conecta Stripe o PayPal). Si no hay nada que pagar al reservar, por ejemplo porque un cheque regalo lo cubre, la reserva se confirma al instante y la respuesta es la de confirmed que aparece más abajo, con una confirmation_url para el huésped.

Sin pago online: "payment": "on_arrival"

Úsalo para una reserva que no necesita página de pago: un huésped que te pagará a la llegada, o una reserva que has tomado por teléfono. La reserva se confirma de inmediato.

curl https://campiamo.com/api/v1/bookings \
  -H "Authorization: Bearer cmp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: phone-2027-0142" \
  -d '{
    "pitch_type_id": "01kwz3mjx2abcdef0123456789",
    "check_in": "2027-06-12",
    "check_out": "2027-06-15",
    "adults": 2,
    "guest": { "name": "Sam Carter", "email": "sam@example.com" },
    "payment": "on_arrival",
    "send_guest_emails": false,
    "price": 80
  }'
{
  "status": "confirmed",
  "booking": {
    "reference": "BK-7QK2MD",
    "pitch_type_id": "01kwz3mjx2abcdef0123456789",
    "pitch_type": "Grass pitch with electric",
    "check_in": "2027-06-12",
    "check_out": "2027-06-15",
    "nights": 3,
    "adults": 2,
    "children": 0,
    "infants": 0,
    "dogs": 0,
    "currency": "GBP",
    "total": 80.0,
    "payment_status": "pay_on_arrival"
  },
  "dashboard_url": "https://campiamo.com/dashboard/bookings/01m7..."
}
  • Con send_guest_emails activado, el huésped recibe tu correo de confirmación habitual. Desactívalo cuando el huésped ya conozca la reserva. Tú sigues recibiendo tu propio aviso de nueva reserva en cualquier caso.
  • price fija tu propio precio para la estancia, igual que la casilla de precio personalizado de una reserva hecha desde el panel. Una tasa turística cobrada con la reserva se añade encima. Omite price y Campiamo calcula el precio.
  • Registra lo que el huésped ha pagado desde la página de la reserva en tu panel.

Envía cada reserva una sola vez

Las redes fallan. Si no recibes respuesta, no puedes saber si la reserva se hizo. Envía una cabecera Idempotency-Key con cada POST /bookings: cualquier texto único tuyo, como tu número de pedido. Si repites una petición con la misma clave y el mismo contenido, recibes la respuesta original y no se crea una segunda reserva.

Cuando algo va mal

Los errores se devuelven como JSON con el estado HTTP correspondiente. code es estable y se puede comprobar con seguridad; message es para personas.

{
  "error": { "code": "validation_failed", "message": "The booking could not be made." },
  "errors": { "check_out": ["This accommodation requires a minimum stay of 2 nights for the selected dates."] }
}
Estado code Qué significa
401 invalid_key La clave falta, es incorrecta o está revocada
403 browser_request La llamada vino de una página web. Llama a la API desde tu servidor
403 key_in_url La clave se envió en la dirección web. Envíala en la cabecera y revoca esa clave
403 ip_not_allowed La llamada vino de una dirección a la que la clave no está restringida
403 plan_required Tu plan ya no incluye la API
403 api_disabled La API está desactivada para tu cuenta. Contacta con soporte
404 not_found No existe esa dirección, o el id no es uno de los tuyos
409 request_in_progress Una petición con esta Idempotency-Key sigue en curso
422 validation_failed Falta un campo o no está permitido. errors indica cuál
422 not_available El tipo de parcela no se puede reservar para esas fechas
422 online_payment_unavailable Se pidió checkout pero el camping no acepta pagos online
422 booking_refused La reserva no se puede aceptar online. Gestiónala en tu panel
422 idempotency_key_reused La Idempotency-Key ya se usó para una petición distinta
429 rate_limited Demasiadas peticiones. Retry-After indica cuánto esperar
503 bookings_paused Las reservas están en pausa brevemente por mantenimiento. Inténtalo de nuevo en breve
503 api_disabled La API está desactivada para todos durante un tiempo breve. Inténtalo más tarde

Límites

  • 120 peticiones por minuto y clave para las consultas.
  • 30 reservas por hora y 200 al día por clave.

Si una clave alcanza el límite diario de reservas te enviamos un correo, porque normalmente significa que un script ha fallado o que una clave se ha filtrado. Si de verdad necesitas más, dínoslo.

Qué no hace la API

Por diseño, la API no puede leer, modificar ni cancelar reservas existentes, leer tu lista de huéspedes, registrar pagos ni ver los datos del registro de viajeros. Eso mantiene la información de tus huéspedes fuera del alcance de una clave filtrada, y mantiene un único lugar, tu panel, como registro de todas las reservas.

¿Sigues con dudas?

Si esta página no ha resuelto tu duda, es nuestra página la que hay que arreglar. Cuéntanoslo.

Contactar