Démarrage rapide

Vous voulez afficher les disponibilités de votre camping sur votre site, envoyer les réservations dans votre comptabilité ou relier un autre outil ? Trois étapes suffisent.

1. Créez votre compte Campernest Pilot et ajoutez votre camping.
2. Dans Réglages › Développeurs, créez une clé de test cn_test_…. Elle travaille sur un camping de démonstration : aucun client n'est prévenu, rien n'est encaissé.
3. Passez en production avec une clé cn_live_… distincte : rien d'autre ne change dans votre code.

KEY="cn_test_xxx"
API="https://api.campernest.eu/v1"

# Emplacements libres du 10 au 17 juillet pour un camping-car de 7,40 m
curl -s "$API/availability?arrival=2027-07-10&departure=2027-07-17&vehicle=motorhome&length=7.4&adults=2" \
  -H "Authorization: Bearer $KEY"

La réponse ne renvoie que les emplacements où le véhicule passe vraiment, avec le prix du séjour. Il ne reste qu'à créer la réservation (voir POST /bookings).

L'essentiel

Clés de test et clés réelles

Une clé cn_test_ travaille sur un camping de démonstration, recréé chaque nuit : vous pouvez réserver, annuler et recevoir des webhooks sans toucher à vos vrais clients.

Une clé cn_live_ agit sur votre camping, pour de vrai. Chaque clé a ses portées : read (lire emplacements, disponibilités et réservations) et write (créer et annuler des réservations). Donnez à chaque outil la plus petite portée possible.

Une clé se crée et se révoque dans Réglages › Développeurs. Seul le propriétaire du camping, ou un membre de l'équipe qui en a le droit, peut le faire.

Le camping de la clé

GET/me

Renvoie le camping lié à la clé, son identifiant et les portées de la clé. Pratique pour vérifier qu'une clé fonctionne.

Emplacements et locatifs

GET/pitches

Vos emplacements et vos locatifs, avec ce qui compte pour un véhicule : longueur et largeur maximales, véhicules acceptés, électricité.

{
  "data": [
    {
      "id": "pch_8f2k1",
      "name": "B12",
      "kind": "pitch",
      "max_length_m": 9.5,
      "max_width_m": 4,
      "vehicles": ["caravan", "motorhome", "van"],
      "electricity_amps": 10
    }
  ],
  "has_more": false
}

Disponibilités

GET/availability

Seuls les emplacements libres où le véhicule passe sont renvoyés, avec le prix total du séjour et la taxe de séjour à part.

Lire les réservations

GET/bookings

GET/bookings/{id}

Filtres : arrival_from, arrival_to, status et updated_since, pour ne relire que ce qui a changé depuis votre dernier passage. Les résultats sont paginés par 50, avec has_more et starting_after.

Créer une réservation

POST/bookings

Envoyez un en-tête Idempotency-Key : si la requête est rejouée, la réservation n'est créée qu'une fois.

curl -s -X POST "$API/bookings" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: site-2027-0412" \
  -d '{"pitch_id":"pch_8f2k1","arrival":"2027-07-10","departure":"2027-07-17",
       "vehicle":"motorhome","length":7.4,"adults":2,
       "guest":{"full_name":"Marie Dupont","email":"marie.dupont@exemple.fr"}}'

POST/bookings/{id}/cancel

Annule une réservation. Le remboursement suit les conditions d'annulation de votre camping.

Statuts d'une réservation

Calendriers iCal

Chaque emplacement et chaque locatif a une adresse iCal en lecture, à coller dans un autre outil ou une autre plateforme. Dans l'autre sens, Campernest Pilot lit les calendriers iCal de vos autres canaux et bloque les dates déjà prises.

Les calendriers iCal se règlent dans le planning, sans clé d'API.

Webhooks

Campernest Pilot prévient votre serveur dès qu'une réservation change, par une requête POST en JSON.

Vérifier la signature (obligatoire)

Chaque envoi porte l'en-tête Campernest-Signature: t=…,v1=…, un HMAC-SHA256 du corps brut calculé avec le secret de votre webhook. Refusez toute requête dont la signature ne correspond pas, ou vieille de plus de 5 minutes.

import { createHmac, timingSafeEqual } from "node:crypto";

export function verify(rawBody, header, secret) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  return timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

Répondez par un code 2xx en moins de 10 secondes. Sinon, l'envoi est retenté pendant 24 heures, à intervalles croissants.

Erreurs

{
  "error": {
    "code": "pitch_too_short",
    "message": "Le véhicule (7,4 m) dépasse la longueur de l'emplacement B12 (6,5 m).",
    "field": "length"
  }
}

Limites

• 60 requêtes par minute et par clé.
• Une réservation ne peut pas dépasser 90 nuits.
• Les données de vos clients ne servent qu'à votre camping : ni revente, ni prospection.