Aller au contenu

API-Changelog

Ce contenu n’est pas encore disponible dans votre langue.

Diese Seite listet jede Änderung an der öffentlichen CampOne-API, die jüngste zuoberst. Die Liste ist abschliessend — was hier nicht steht, hat sich nicht geändert.

Erste öffentliche Veröffentlichung der v1-API.

Hinzugefügt:

  • GET /api/v1/public/bookings/ — Buchungen auflisten (Geltungsbereich bookings:read)
  • POST /api/v1/public/bookings/ — Buchung im Status pending anlegen (Geltungsbereich bookings:write)
  • GET /api/v1/public/bookings/{id}/ — Buchungsdetail (Geltungsbereich bookings:read)
  • GET /api/v1/public/sites/ — Stellplätze auflisten (Geltungsbereich sites:read)
  • GET /api/v1/public/customers/ — Kunden auflisten (Geltungsbereich customers:read)
  • GET /api/v1/public/invoices/ — Rechnungen auflisten (Geltungsbereich invoices:read)

Die API folgt innerhalb einer Major-Version den unten stehenden Regeln. Sie sind Zusagen, auf die sich Integratoren verlassen können:

  • Additive Änderungen sind innerhalb von v1 erlaubt. Neue Endpunkte, neue optionale Query-Parameter und neue Felder in bestehenden JSON-Antworten können jederzeit in einer Minor-Version ausgeliefert werden.
  • Keine entfernten Felder, keine umbenannten Felder, keine Typänderungen innerhalb von v1. Ein Feld, das heute auf einer v1-Antwort existiert, existiert für die gesamte Lebensdauer von v1 mit gleichem Namen und gleichem Typ.
  • Keine neuen Pflichtfelder in Anfragen innerhalb von v1. Bestehende POST-Aufrufe, die gestern funktioniert haben, funktionieren morgen ohne Anpassung des Aufrufers weiter.
  • Brechende Änderungen erscheinen als v2. Wird v2 angekündigt, läuft v1 danach mindestens 12 Monate weiter. Migrationsfenster und Deprecation-Zeitachsen werden im Voraus über dieses Changelog und über mandantengerichtete Kanäle kommuniziert.

Jeder Release-Eintrag verwendet dieselben Überschriften:

  • Hinzugefügt — neue Endpunkte, neue optionale Parameter, neue Antwortfelder
  • Geändert — nicht-brechende Anpassungen an bestehendem Verhalten (z. B. gelockerte Validierung, erweiterte Enum-Werte)
  • Behoben — Bugfixes, die die Implementierung mit dieser Dokumentation in Einklang bringen
  • Veraltet — Funktionen, die noch funktionieren, aber zur Entfernung in einer zukünftigen Major-Version vorgesehen sind
  • Entfernt — erscheint nur in einem v2+-Eintrag, niemals innerhalb einer stabilen Major-Version

Fehlt eine Überschrift in einem Release-Eintrag, gibt es in dieser Veröffentlichung keine Änderungen dieser Art.