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
- En tu panel, ve a Ajustes → API.
- Elige Crear clave, ponle un nombre que vayas a reconocer («Sitio web», «Formulario de reserva») y confirma con tu contraseña.
- 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_emailsactivado, 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. pricefija 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. Omitepricey 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