Stellplätze

Ein Stellplatz ist eine einzelne Parzelle auf dem Campingplatz — eine nummerierte Fläche, die ein Gast buchen kann. Jeder Stellplatz hat einen Typ (Zeltplatz, Wohnmobilstellplatz, Mobilheim usw.), einen nächtlichen Grundpreis und eine maximale Belegung.

Der Stellplatz-Endpunkt stellt einen rein lesenden Katalog bereit. Nutzen Sie ihn, um die Stellplatz-IDs zu ermitteln, die POST /api/v1/public/bookings/ erwartet, oder um den Stellplatzbestand eines Mandanten in einem anderen System zu spiegeln.

Stellplätze auflisten

GET /api/v1/public/sites/

Erforderlicher Geltungsbereich: sites:read

Query-Parameter:

Name	Typ	Standard	Beschreibung
page	integer	1	Seitennummer, 1-indiziert
page_size	integer	50	Einträge pro Seite (max. 200)

In v1 sind keine Filter verfügbar. Standardsortierung: site_number aufsteigend — natürliche Reihenfolge des Platzlayouts. Den vollständigen Paginierungsvertrag finden Sie unter Paginierung und Filterung.

Antwort 200:

{
  "count": 84,
  "next": "https://api.campone.ch/api/v1/public/sites/?page=2",
  "previous": null,
  "results": [
    {
      "id": 312,
      "site_number": "A12",
      "name": "Seeblick Standard",
      "max_occupants": 4,
      "base_price_per_night": "55.00",
      "status": "active",
      "site_type_id": 7,
      "site_type_name": "Wohnmobil"
    }
  ]
}

Antwortfelder (pro Ergebnis):

Feld	Typ	Beschreibung
id	integer	Primärschlüssel des Stellplatzes. Beim Anlegen einer Buchung als site_id zu verwenden
site_number	string	Stellplatznummer wie auf dem Platzplan angezeigt (z. B. "A12")
name	string	Vom Betreiber vergebener Beschreibungsname (kann leer sein)
max_occupants	integer	Maximale Gesamtbelegung, für die der Stellplatz ausgelegt ist
base_price_per_night	decimal string (CHF)	Vom Betreiber festgelegter Grundpreis. Der endgültige Gästepreis hängt von Saison, Belegung und Kurtaxe ab — dies ist ein Ausgangswert, kein finales Angebot
status	string	Betriebsstatus des Stellplatzes (active, inactive usw.)
site_type_id	integer	ID des Stellplatztyps, zu dem dieser Stellplatz gehört
site_type_name	string	Lesbarer Name des Stellplatztyps (z. B. "Wohnmobil", "Zelt", "Mobilheim")

Fehler: 401, 403, 429. Die Antwortformen finden Sie unter Fehler und Statuscodes.

Beispiel (curl):

curl -H "Authorization: Bearer ck_a1b2c3d4XXXXXXXXXXXXXXXXXXXXXXXX" \
     "https://api.campone.ch/api/v1/public/sites/?page=1&page_size=200"

Beispiel (Python):

import requests

r = requests.get(
    "https://api.campone.ch/api/v1/public/sites/",
    headers={"Authorization": "Bearer ck_a1b2c3d4XXXXXXXXXXXXXXXXXXXXXXXX"},
    params={"page": 1, "page_size": 200},
)
r.raise_for_status()
data = r.json()
for site in data["results"]:
    print(site["site_number"], site["site_type_name"], site["base_price_per_night"])

Häufige Stolpersteine

Stellplatz-IDs sind mandantenbezogen. Eine site_id, die der Schlüssel eines Mandanten liefert, hat für einen anderen Mandanten keine Bedeutung. Werden IDs in einem Folgesystem gespeichert, sollte der Mandant Teil des Schlüssels sein.

base_price_per_night ist nicht der gebuchte Preis. Es ist der vom Betreiber konfigurierte Ausgangspreis des Stellplatzes und ignoriert Saisonpreise, Belegungsanpassungen und Kurtaxe. Geeignet für die Katalogdarstellung, nicht für die Abrechnung. Der tatsächlich abgerechnete Betrag steht auf der zugehörigen Rechnung — siehe den Rechnungs-Endpunkt.

Keine Verfügbarkeitsdaten hier. Dieser Endpunkt liefert den statischen Stellplatzkatalog. Um zu wissen, ob ein Stellplatz für einen bestimmten Datumsbereich frei ist, listen Sie Buchungen auf demselben Stellplatz auf und schneiden Sie die Datumsbereiche clientseitig. Ein dedizierter Verfügbarkeits-Endpunkt steht auf der Roadmap.