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
- Gehen Sie in Ihrem Dashboard zu Einstellungen → API.
- Wählen Sie Schlüssel erstellen, geben Sie ihm einen Namen, den Sie wiedererkennen („Website“, „Buchungsformular“), und bestätigen Sie mit Ihrem Passwort.
- 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_emailseingeschaltet, 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. pricelegt 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 Siepriceweg, 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