Skip to main content

Buchungs-API: Buchungen auf Ihrer eigenen Website annehmen

Eine kleine, sichere JSON-API für Ihren Campingplatz: Stellplatztypen, Extras, Verfügbarkeit und Preise abrufen und Buchungen anlegen. Alles danach verwalten Sie in Ihrem Campiamo-Dashboard.

Zuletzt aktualisiert: 9. November 2026

Mit der Buchungs-API kann Ihre eigene Website Buchungen in Campiamo anlegen. Sie tut zwei Dinge: Sie sagt Ihnen, was gebucht werden kann (Stellplatztypen, Extras, Verfügbarkeit und Preise), und sie legt Buchungen an. Ändern, Stornieren, Restbeträge einziehen und Gäste einchecken geschieht in Ihrem Campiamo-Dashboard, wie bei jeder anderen Buchung auch.

Die Buchungs-API ist ab dem Growth-Tarif enthalten.

Wenn Sie nur ein Buchungsformular auf Ihrer eigenen Website möchten, brauchen Sie die API nicht: Das Buchungs-Widget erledigt das mit einer Zeile Code. Die API ist für den Fall gedacht, dass Sie das Buchungsformular selbst bauen möchten.

Bevor Sie beginnen

  1. Gehen Sie in Ihrem Dashboard zu Einstellungen → API.
  2. Wählen Sie Schlüssel erstellen, geben Sie ihm einen Namen, den Sie wiedererkennen („Website“, „Buchungsformular“), und bestätigen Sie mit Ihrem Passwort.
  3. Kopieren Sie den Schlüssel. Er wird einmal angezeigt. Wir speichern nur einen Fingerabdruck davon, sodass niemand, auch wir nicht, ihn Ihnen noch einmal zeigen kann. Wenn Sie ihn verlieren, widerrufen Sie ihn und erstellen Sie einen neuen.

Ein Schlüssel gehört zu einem Campingplatz. Sie können bis zu fünf haben und jeden davon jederzeit widerrufen; ein widerrufener Schlüssel funktioniert sofort nicht mehr.

Bewahren Sie den Schlüssel auf Ihrem Server auf

Der Schlüssel ist ein Passwort, mit dem sich Buchungen auf Ihrem Campingplatz anlegen lassen. Behandeln Sie ihn entsprechend:

  • Rufen Sie die API nur von Ihrem Server aus auf, nie aus JavaScript in einer Webseite oder aus einer mobilen App, wo ihn jeder lesen kann. Die API lehnt Aufrufe aus Browsern auf anderen Websites ab.
  • Schreiben Sie ihn nicht in eine Webadresse, eine E-Mail oder ein öffentliches Code-Repository.
  • Wenn Sie die Adresse kennen, von der aus Ihr Server aufruft, binden Sie den Schlüssel unter Erlaubte IP-Adressen daran.
  • Wenn Sie glauben, dass ein Schlüssel in falsche Hände geraten ist, widerrufen Sie ihn. Sie erhalten eine E-Mail, sobald in Ihrem Konto ein Schlüssel erstellt oder widerrufen wird.

Eine Anfrage stellen

Die Basisadresse lautet:

https://campiamo.com/api/v1

Senden Sie Ihren Schlüssel bei jeder Anfrage im Authorization-Header, über HTTPS:

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

Anfragen und Antworten sind JSON. Datumsangaben haben das Format YYYY-MM-DD, und check_out ist der Morgen, an dem der Gast abreist. Preise sind Zahlen in der Währung Ihres Campingplatzes.

Was gebucht werden kann

Ihr Campingplatz

GET /campsite liefert, was ein Buchungsformular über Ihren Platz wissen muss.

{
  "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 sind Ihre benutzerdefinierten Buchungsfelder. Senden Sie die Antworten beim Anlegen einer Buchung in answers zurück, mit der id der jeweiligen Frage als Schlüssel.

Stellplatztypen

GET /pitch-types listet die Stellplatztypen und Unterkünfte auf, die Gäste buchen können.

{
  "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 ist der Ausgangspreis. Saisons, Mindestaufenthalte und die Größe der Reisegruppe verändern, was ein Aufenthalt kostet. Holen Sie den Preis für konkrete Daten daher immer aus der Verfügbarkeit oder aus einem Angebot.

Extras

GET /extras listet die Extras auf, die ein Gast hinzufügen kann. pitch_type_ids ist leer, wenn ein Extra bei jedem Stellplatztyp angeboten wird.

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

Verfügbarkeit

GET /availability beantwortet die Frage: „Was ist für diese Daten und diese Reisegruppe frei, und was kostet es?“

Parameter
check_in erforderlich Anreisedatum
check_out erforderlich Abreisedatum
adults optional Standard 2
children optional Standard 0
infants optional Standard 0
dogs optional Standard 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 ist der Betrag, den der Gast nach Ihren Anzahlungsregeln beim Bezahlen zahlen würde. Der reason für einen nicht verfügbaren Stellplatztyp ist einer der Werte closed, adults_only, too_many_people, no_dogs, too_many_dogs, maximum_stay, not_offered, minimum_stay, fully_booked oder no_price.

Ein Angebot

POST /quotes berechnet den Preis für einen Stellplatztyp mit Extras und Codes, ohne etwas zu buchen. Es nimmt dieselben Felder zum Aufenthalt entgegen wie eine Buchung.

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 sind die Zuschläge für Personen oder Hunde, die über die im Stellplatzpreis enthaltenen hinausgehen. tourist_tax ist ausgefüllt, wenn Ihr Campingplatz eine Kurtaxe erhebt; wird sie mit der Buchung erhoben, ist sie bereits in total enthalten.

Eine Buchung anlegen

POST /bookings legt eine Buchung an. Sie wird nach denselben Regeln geprüft wie in Ihrem Buchungs-Widget: Saison, Verfügbarkeit, Mindestaufenthalte, Größe der Reisegruppe, Hunde, Pflichtfragen und Extras. Wenn ein Gast die Buchung auf Ihrer Buchungsseite nicht machen könnte, macht die API sie auch nicht.

Feld
pitch_type_id erforderlich Aus den Stellplatztypen oder der Verfügbarkeit
check_in, check_out erforderlich Heute oder später
adults erforderlich Mindestens 1
children, infants, dogs optional Standard 0
child_ages erforderlich bei Kindern Ein Alter pro Kind, z. B. [4, 9]
guest.name, guest.email erforderlich
guest.phone optional Erforderlich, wenn Ihr Campingplatz eine Telefonnummer verlangt
guest.address optional line_1, line_2, city, county, postcode
extras optional [{ "extra_id": "...", "quantity": 1, "choice": "..." }]
answers optional Antworten auf Ihre Buchungsfragen, mit der ID der Frage als Schlüssel
discount_code, voucher_code optional
notes optional Bis zu 1.000 Zeichen
payment erforderlich checkout oder on_arrival, siehe unten
send_guest_emails optional Nur bei on_arrival. Standard true
price optional Nur bei on_arrival. Ihr eigener Gesamtbetrag für diese Buchung anstelle des berechneten

Der Gast zahlt online: "payment": "checkout"

Verwenden Sie das, wenn ein Gast auf Ihrer Website bucht. Sie erhalten einen Link zu einer sicheren Zahlungsseite zurück, die Ihr Zahlungsanbieter hostet. Leiten Sie den Browser des Gastes dorthin.

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
}

Die Buchung entsteht, wenn der Gast bezahlt. Der Stellplatz wird reserviert, solange der Gast auf der Zahlungsseite ist. Sobald er bezahlt, erscheint die Buchung in Ihrem Dashboard, er landet auf einer Bestätigungsseite und erhält Ihre Bestätigungs-E-Mail mit seiner Buchungsnummer. Verlässt er die Seite, ohne zu bezahlen, wird nichts gebucht, und der Stellplatz wird freigegeben.

Ihr Campingplatz muss dafür Online-Zahlungen annehmen (Stripe verbinden oder PayPal). Ist beim Bezahlen nichts fällig, etwa weil ein Geschenkgutschein den Betrag deckt, wird die Buchung sofort bestätigt, und die Antwort ist die unten gezeigte confirmed-Antwort mit einer confirmation_url für den Gast.

Keine Online-Zahlung: "payment": "on_arrival"

Verwenden Sie das für eine Buchung, die keine Zahlungsseite braucht: ein Gast, der bei Anreise bei Ihnen zahlt, oder eine Buchung, die Sie telefonisch angenommen haben. Die Buchung wird sofort bestätigt.

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..."
}
  • Bleibt send_guest_emails eingeschaltet, erhält der Gast Ihre übliche Bestätigungs-E-Mail. Schalten Sie es aus, wenn der Gast bereits von der Buchung weiß. Ihre eigene Benachrichtigung über die neue Buchung erhalten Sie in beiden Fällen.
  • price legt Ihren eigenen Preis für den Aufenthalt fest, genau wie das Feld für den individuellen Preis bei einer Buchung aus dem Dashboard. Eine Kurtaxe, die mit der Buchung erhoben wird, kommt obendrauf. Lassen Sie price weg, berechnet Campiamo den Preis.
  • Was der Gast bezahlt hat, erfassen Sie auf der Seite der Buchung in Ihrem Dashboard.

Senden Sie jede Buchung nur einmal

Netzwerke fallen aus. Wenn Sie keine Antwort erhalten, können Sie nicht wissen, ob die Buchung angelegt wurde. Senden Sie bei jedem POST /bookings einen Idempotency-Key-Header mit: einen beliebigen eindeutigen eigenen Text, etwa Ihre Bestellnummer. Wenn Sie eine Anfrage mit demselben Schlüssel und demselben Inhalt wiederholen, erhalten Sie die ursprüngliche Antwort zurück, und es wird keine zweite Buchung angelegt.

Wenn etwas nicht stimmt

Fehler kommen als JSON mit dem passenden HTTP-Status zurück. code ist stabil und kann gefahrlos abgefragt werden; message ist für Menschen gedacht.

{
  "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."] }
}
Status code Was es bedeutet
401 invalid_key Der Schlüssel fehlt, ist falsch oder wurde widerrufen
403 browser_request Der Aufruf kam von einer Webseite. Rufen Sie die API von Ihrem Server aus auf
403 key_in_url Der Schlüssel wurde in der Webadresse gesendet. Senden Sie ihn im Header und widerrufen Sie diesen Schlüssel
403 ip_not_allowed Der Aufruf kam von einer Adresse, an die der Schlüssel nicht gebunden ist
403 plan_required Ihr Tarif enthält die API nicht mehr
403 api_disabled Die API ist für Ihr Konto abgeschaltet. Wenden Sie sich an den Support
404 not_found Diese Adresse gibt es nicht, oder die ID gehört nicht zu Ihnen
409 request_in_progress Eine Anfrage mit diesem Idempotency-Key läuft noch
422 validation_failed Ein Feld fehlt oder ist nicht zulässig. errors sagt, welches
422 not_available Der Stellplatztyp kann für diese Daten nicht gebucht werden
422 online_payment_unavailable checkout wurde angefordert, aber der Campingplatz nimmt keine Online-Zahlungen an
422 booking_refused Die Buchung kann nicht online angenommen werden. Bearbeiten Sie sie in Ihrem Dashboard
422 idempotency_key_reused Der Idempotency-Key wurde bereits für eine andere Anfrage verwendet
429 rate_limited Zu viele Anfragen. Retry-After sagt, wie lange Sie warten müssen
503 bookings_paused Buchungen sind wegen Wartungsarbeiten kurz pausiert. Versuchen Sie es gleich noch einmal
503 api_disabled Die API ist für kurze Zeit für alle abgeschaltet. Versuchen Sie es später noch einmal

Limits

  • 120 Anfragen pro Minute und Schlüssel für Abfragen.
  • 30 Buchungen pro Stunde und 200 pro Tag und Schlüssel.

Wenn ein Schlüssel das tägliche Buchungslimit erreicht, schreiben wir Ihnen eine E-Mail, denn das bedeutet meist, dass ein Skript fehlerhaft läuft oder ein Schlüssel in falsche Hände geraten ist. Wenn Sie wirklich mehr brauchen, sagen Sie uns Bescheid.

Was die API nicht tut

Die API kann bewusst keine bestehenden Buchungen lesen, ändern oder stornieren, Ihre Gästeliste nicht lesen, keine Zahlungen erfassen und keine Meldedaten von Reisenden einsehen. So bleiben die Daten Ihrer Gäste außer Reichweite eines Schlüssels, der in falsche Hände geraten ist, und Ihr Dashboard bleibt der eine Ort, an dem jede Buchung verzeichnet ist.

Kommen Sie nicht weiter?

Wenn diese Seite Ihre Frage nicht beantwortet hat, müssen wir die Seite verbessern. Sagen Sie uns Bescheid.

Kontakt aufnehmen