Entwickler Änderungsprotokoll
Versionierung und Änderungsprotokoll
Wie die CLUP.life-API versioniert wird und was sich wann geändert hat.
Versionierung#
- Die Version steht im Pfad:
/api/v1/…. Die aktuelle Version ist v1. - Innerhalb von v1 ändern wir nur rückwärtskompatibel: neue Routen, neue optionale Parameter, neue Felder in Antworten, neue Bereiche, neue Webhook-Ereignisse und neue MCP-Werkzeuge. Schreibe deinen Code deshalb tolerant: unbekannte Felder und unbekannte Ereignisarten ignorieren.
- Inkompatible Änderungen (Felder entfernen, Bedeutung ändern) gibt es nur mit einer neuen Version im Pfad und werden hier vorab angekündigt. Die Frist für Abkündigungen legen wir fest, bevor die erste inkompatible Änderung ansteht, und nennen sie an dieser Stelle.
- Die Versionsnummer der Beschreibung steht in
info.versionder OpenAPI-Datei.
Spezifikation herunterladen#
Die OpenAPI-3.1-Beschreibung lässt sich in Swagger UI, Postman, Insomnia oder einen Codegenerator importieren: openapi.json · openapi.yaml. Die Datei wird aus derselben Quelle erzeugt wie die API selbst; die Live-Fassung liefert GET /api/v1/ext/openapi.json (ohne Schlüssel).
Änderungsprotokoll#
NeuDocs
Die Entwicklerdokumentation ist öffentlich unter /entwickler: Referenz aus der OpenAPI-Beschreibung, Beispiele in curl, JavaScript und Python, Webhook-Empfänger, MCP-Einrichtung, „Ausprobieren“-Konsole. Die Spezifikation gibt es als JSON und YAML zum Herunterladen.
Neuv1.0.0
Erste Fassung der Schnittstelle v1: persönliche Lese-Schlüssel (Basis), Organisationsschlüssel mit Schreibzugriff auf Termine, Mitteilungen und Aufgaben (Premium), Exporte als iCal/CSV, signierte Webhooks (8 Ereignisse, Premium) und der MCP-Server mit 9 Werkzeugen.