Skip to main content

API de réservation : prenez des réservations sur votre propre site web

Une petite API JSON sécurisée pour votre camping : lisez vos types d’emplacement, vos suppléments, vos disponibilités et vos prix, et créez des réservations. Tout le reste se gère ensuite dans votre tableau de bord Campiamo.

Dernière mise à jour : 9 novembre 2026

L’API de réservation permet à votre propre site web d’enregistrer des réservations dans Campiamo. Elle fait deux choses : elle vous indique ce qui peut être réservé (types d’emplacement, suppléments, disponibilités et prix), et elle crée des réservations. Modifier, annuler, encaisser les soldes et enregistrer l’arrivée des clients, tout cela se fait dans votre tableau de bord Campiamo, comme pour n’importe quelle autre réservation.

L’API de réservation fait partie du forfait Growth et des forfaits supérieurs.

Si vous voulez simplement un formulaire de réservation sur votre propre site web, vous n’avez pas besoin de l’API : le widget de réservation le fait en une ligne de code. L’API sert quand vous voulez construire vous-même le formulaire de réservation.

Avant de commencer

  1. Dans votre tableau de bord, allez dans Paramètres → API.
  2. Choisissez Créer la clé, donnez-lui un nom que vous reconnaîtrez (« Site web », « Formulaire de réservation ») et confirmez avec votre mot de passe.
  3. Copiez la clé. Elle n’est affichée qu’une seule fois. Nous n’en conservons qu’une empreinte : personne, pas même nous, ne peut donc vous la montrer de nouveau. Si vous la perdez, révoquez-la et créez-en une autre.

Une clé appartient à un seul camping. Vous pouvez en avoir jusqu’à cinq, et vous pouvez révoquer n’importe laquelle à tout moment ; une clé révoquée cesse de fonctionner immédiatement.

Gardez la clé sur votre serveur

La clé est un mot de passe permettant de créer des réservations dans votre camping. Traitez-la comme tel :

  • N’appelez l’API que depuis votre serveur, jamais depuis du JavaScript dans une page web ni depuis une application mobile, où n’importe qui peut la lire. L’API refuse les appels provenant de navigateurs sur d’autres sites.
  • Ne la mettez pas dans une adresse web, un e-mail ou un dépôt de code public.
  • Si vous connaissez l’adresse depuis laquelle votre serveur appelle, restreignez la clé à cette adresse dans Adresses IP autorisées.
  • Si vous pensez qu’une clé a fuité, révoquez-la. Vous recevez un e-mail chaque fois qu’une clé est créée ou révoquée sur votre compte.

Envoyer une requête

L’adresse de base est :

https://campiamo.com/api/v1

Envoyez votre clé dans l’en-tête Authorization de chaque requête, en HTTPS :

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

Les requêtes et les réponses sont en JSON. Les dates sont au format YYYY-MM-DD, et check_out est le matin où le client s’en va. Les prix sont des nombres dans la devise de votre camping.

Ce qui peut être réservé

Votre camping

GET /campsite renvoie ce qu’un formulaire de réservation doit savoir sur votre 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 correspond à vos champs de réservation personnalisés. Renvoyez les réponses dans answers lorsque vous créez une réservation, indexées par l’id de chaque question.

Types d’emplacement

GET /pitch-types liste les types d’emplacement et les hébergements que les clients peuvent réserver.

{
  "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 est le prix de départ. Les saisons, les durées minimales de séjour et la taille du groupe modifient le coût d’un séjour : prenez donc toujours le prix pour des dates réelles dans les disponibilités ou dans un devis.

Suppléments

GET /extras liste les suppléments qu’un client peut ajouter. pitch_type_ids est vide lorsqu’un supplément est proposé avec tous les types d’emplacement.

{
  "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": []
    }
  ]
}

Disponibilités

GET /availability répond à la question « qu’est-ce qui est libre pour ces dates et ce groupe, et combien cela coûte-t-il ? »

Paramètre
check_in obligatoire Date d’arrivée
check_out obligatoire Date de départ
adults facultatif 2 par défaut
children facultatif 0 par défaut
infants facultatif 0 par défaut
dogs facultatif 0 par défaut
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 est ce que le client paierait au moment du paiement selon vos règles d’acompte. La reason d’un type d’emplacement indisponible est l’une des valeurs suivantes : closed, adults_only, too_many_people, no_dogs, too_many_dogs, maximum_stay, not_offered, minimum_stay, fully_booked ou no_price.

Un devis

POST /quotes calcule le prix d’un type d’emplacement avec des suppléments et des codes, sans rien réserver. Il prend les mêmes champs de séjour qu’une réservation.

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 correspond aux frais pour les personnes ou les chiens au-delà de ceux inclus dans le prix de l’emplacement. tourist_tax est renseigné lorsque votre camping collecte une taxe de séjour ; lorsqu’elle est collectée avec la réservation, elle est déjà comprise dans total.

Créer une réservation

POST /bookings crée une réservation. Elle est contrôlée selon les mêmes règles que votre widget de réservation : la saison, les disponibilités, les durées minimales de séjour, la taille du groupe, les chiens, les questions obligatoires et les suppléments. Si un client ne pouvait pas faire la réservation sur votre page de réservation, l’API ne la fera pas non plus.

Champ
pitch_type_id obligatoire Issu des types d’emplacement ou des disponibilités
check_in, check_out obligatoire Aujourd’hui ou plus tard
adults obligatoire Au moins 1
children, infants, dogs facultatif 0 par défaut
child_ages obligatoire s’il y a des enfants Un âge par enfant, par ex. [4, 9]
guest.name, guest.email obligatoire
guest.phone facultatif Obligatoire si votre camping exige un numéro de téléphone
guest.address facultatif line_1, line_2, city, county, postcode
extras facultatif [{ "extra_id": "...", "quantity": 1, "choice": "..." }]
answers facultatif Réponses à vos questions de réservation, indexées par l’id de la question
discount_code, voucher_code facultatif
notes facultatif Jusqu’à 1 000 caractères
payment obligatoire checkout ou on_arrival, voir ci-dessous
send_guest_emails facultatif on_arrival uniquement. true par défaut
price facultatif on_arrival uniquement. Votre propre total pour cette réservation, à la place du total calculé

Le client paie en ligne : "payment": "checkout"

Utilisez ce mode quand un client réserve sur votre site web. Vous recevez en retour un lien vers une page de paiement sécurisée hébergée par votre prestataire de paiement. Envoyez-y le navigateur du client.

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 réservation est créée quand le client paie. L’emplacement est retenu tant qu’il est sur la page de paiement. Une fois le paiement effectué, la réservation apparaît dans votre tableau de bord, le client arrive sur une page de confirmation et reçoit votre e-mail de confirmation avec sa référence de réservation. S’il part sans payer, rien n’est réservé et l’emplacement est libéré.

Votre camping doit accepter les paiements en ligne pour cela (connectez Stripe ou PayPal). Si rien n’est dû au moment du paiement, par exemple parce qu’un chèque-cadeau couvre le tout, la réservation est confirmée immédiatement et la réponse est la réponse confirmed ci-dessous, avec une confirmation_url pour le client.

Sans paiement en ligne : "payment": "on_arrival"

Utilisez ce mode pour une réservation qui n’a pas besoin de page de paiement : un client qui vous paiera à l’arrivée, ou une réservation prise par téléphone. La réservation est confirmée immédiatement.

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..."
}
  • Si send_guest_emails reste activé, le client reçoit votre e-mail de confirmation habituel. Désactivez-le quand le client est déjà au courant de la réservation. Dans les deux cas, vous recevez toujours votre propre alerte de nouvelle réservation.
  • price définit votre propre prix pour le séjour, comme le champ de prix personnalisé d’une réservation créée dans le tableau de bord. Une taxe de séjour collectée avec la réservation s’y ajoute. Omettez price et Campiamo calcule le prix.
  • Enregistrez ce que le client a payé depuis la page de la réservation dans votre tableau de bord.

Envoyez chaque réservation une seule fois

Les réseaux tombent en panne. Si vous ne recevez pas de réponse, vous ne pouvez pas savoir si la réservation a été créée. Envoyez un en-tête Idempotency-Key avec chaque POST /bookings : n’importe quel texte unique de votre choix, tel que votre numéro de commande. Si vous répétez une requête avec la même clé et le même contenu, vous recevez la réponse d’origine et aucune seconde réservation n’est créée.

En cas de problème

Les erreurs reviennent en JSON avec le statut HTTP correspondant. code est stable et peut être testé sans risque ; message est destiné aux personnes.

{
  "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."] }
}
Statut code Ce que cela signifie
401 invalid_key La clé est absente, erronée ou révoquée
403 browser_request L’appel venait d’une page web. Appelez l’API depuis votre serveur
403 key_in_url La clé a été envoyée dans l’adresse web. Envoyez-la dans l’en-tête et révoquez cette clé
403 ip_not_allowed L’appel venait d’une adresse à laquelle la clé n’est pas restreinte
403 plan_required Votre forfait ne comprend plus l’API
403 api_disabled L’API est désactivée pour votre compte. Contactez l’assistance
404 not_found Adresse inexistante, ou l’id n’est pas l’un des vôtres
409 request_in_progress Une requête avec cette Idempotency-Key est encore en cours
422 validation_failed Un champ est manquant ou non autorisé. errors indique lequel
422 not_available Le type d’emplacement ne peut pas être réservé pour ces dates
422 online_payment_unavailable checkout a été demandé mais le camping n’accepte pas les paiements en ligne
422 booking_refused La réservation ne peut pas être prise en ligne. Traitez-la dans votre tableau de bord
422 idempotency_key_reused L’Idempotency-Key a déjà été utilisée pour une autre requête
429 rate_limited Trop de requêtes. Retry-After indique combien de temps attendre
503 bookings_paused Les réservations sont brièvement suspendues pour maintenance. Réessayez sous peu
503 api_disabled L’API est désactivée pour tout le monde pendant un court moment. Réessayez plus tard

Limites

  • 120 requêtes par minute et par clé pour les consultations.
  • 30 réservations par heure et 200 par jour, par clé.

Si une clé atteint la limite quotidienne de réservations, nous vous écrivons, car cela signifie en général qu’un script a mal tourné ou qu’une clé a fuité. Si vous avez un réel besoin de davantage, dites-le-nous.

Ce que l’API ne fait pas

Par conception, l’API ne peut pas lire, modifier ou annuler des réservations existantes, lire votre liste de clients, enregistrer des paiements ni voir les données d’enregistrement des voyageurs. Cela met les informations de vos clients hors de portée d’une clé qui aurait fuité, et cela garde un seul endroit, votre tableau de bord, comme registre de chaque réservation.

Toujours bloqué ?

Si cette page n’a pas répondu à votre question, c’est notre page qu’il faut corriger. Dites-le-nous.

Nous contacter