API-Übersicht
Die CampOne-API stellt Drittsystemen einen überwiegend lesenden Zugriff auf die operativen Daten eines Mandanten über HTTPS zur Verfügung — nach REST-Konventionen und mit JSON-Inhalten.
Was die API ist
Abschnitt betitelt „Was die API ist“Eine versionierte, authentifizierte REST-Schnittstelle für die Daten eines einzelnen Mandanten. Authentifiziert wird auf Mandantenebene (nicht als einzelner Benutzer). Die meisten Ressourcen werden gelesen, Buchungen können angelegt werden. Alle Antworten sind JSON. Alle Anfragen verwenden das Bearer-Token-Schema, das in der Authentifizierung beschrieben ist.
Der derzeitige Geltungsbereich umfasst:
- Buchungen — auflisten, abrufen, anlegen
- Stellplätze — auflisten
- Kunden — auflisten
- Rechnungen — auflisten
Für wen sie gedacht ist
Abschnitt betitelt „Für wen sie gedacht ist“Diese API ist für Backoffice- und Partnerintegrationen ausgelegt:
- Channel-Manager, die Verfügbarkeiten und Reservierungen synchronisieren
- Buchhaltungs- und ERP-Systeme, die Rechnungen abrufen
- Partner-Tools, die einen strukturierten Blick auf Buchungen oder den Kundenstamm eines Mandanten benötigen
Es handelt sich nicht um eine gastseitige API. Gäste interagieren mit dem Buchungs-Widget des Betreibers und dem Gastportal — beides eigenständige Produkte. Bauen Sie keine öffentlich zugängliche Reservierungsseite direkt auf diesen Endpunkten auf.
Basis-URL
Abschnitt betitelt „Basis-URL“| Umgebung | Basis-URL |
|---|---|
| Produktion | https://api.campone.ch |
| Staging | https://api-staging.campone.ch |
Alle Pfade in dieser Referenz sind relativ zur Basis-URL plus dem Versionspräfix (siehe unten).
Versionierung
Abschnitt betitelt „Versionierung“Die aktuelle Version ist v1. Jeder Endpunkt liegt unter:
/api/v1/public/...Innerhalb von v1 werden ausschliesslich additive Änderungen vorgenommen:
- Neue Endpunkte
- Neue optionale Query-Parameter
- Neue Felder in JSON-Antworten
Bestehende v1-Felder werden nicht umbenannt, entfernt oder umtypisiert. Jede Änderung, die einen Konsumenten brechen würde, fliesst in ein zukünftiges /api/v2/, während v1 während eines Deprecation-Fensters weiterläuft.
Planen Sie entsprechend: Ignorieren Sie unbekannte Felder, anstatt sie zurückzuweisen, und verlassen Sie sich nicht auf die Reihenfolge der Felder.
Die vollständige Historie versionierter Änderungen findet sich im API-Changelog.
Was nicht in v1 enthalten ist
Abschnitt betitelt „Was nicht in v1 enthalten ist“Folgende Bereiche existieren auf der Plattform, sind aber noch nicht öffentlich zugänglich:
- POS-Transaktionen und Tagesabschlussberichte
- Gutscheine und Geschenkkarten
- Channel-Manager-Push (nur lesende Endpunkte sind freigegeben)
- Stellplatz-Infrastruktur (Sanitärblöcke, Stromsäulen, Stromzähler)
- HESTA / Gastregistrierungsdaten
- Daten aus Treueprogrammen
Wird einer dieser Bereiche benötigt, wenden Sie sich an Ihren Ansprechpartner bei CampOne — er wird in einer späteren API-Version ergänzt, sobald der Vertrag stabil genug für eine Festlegung ist.
Nächste Schritte
Abschnitt betitelt „Nächste Schritte“- Lesen Sie Authentifizierung, um zu verstehen, wie API keys, Geltungsbereiche und der Bearer-Header zusammenspielen.
- Überfliegen Sie Fehler und Statuscodes sowie Paginierung und Filterung, bevor Sie mit der Umsetzung beginnen — die Konventionen sind auf jedem Endpunkt gleich.
- Wenden Sie sich anschliessend den Seiten der einzelnen Endpunkte für Buchungen, Stellplätze, Kunden und Rechnungen zu.