Zum Inhalt springen
CLUP.life

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.version der 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#

  1. Neuv1.7.0

    Fördertopfverzeichnis: `GET /ext/funding` (Bereich `foerderung:read`) durchsucht öffentlich sichtbare Förderprogramme mit Volltext (`q`), Geber (`geber`), Förderart (`art`), Zielgruppe (`zielgruppe`), Thema (`thema`), Region (`region`), Stand (`status`), Sortierung (`sort`) und Cursor. Es gibt nur Einträge der Stufe „öffentlich“, ohne Kontaktangabe; Angaben ohne Gewähr, maßgeblich ist die Originalquelle (`sourceUrl`). MCP-Werkzeug `clup_search_funding`. Neue Webhook-Ereignisse `foerderprogramm.created`, `foerderprogramm.updated` und `foerderprogramm.deleted` für eigene Einträge einer Organisation (nur Kennungen). Anträge, Merkliste und Auswertung gibt es bewusst nicht per Schlüssel.

  2. Neuv1.1.0

    Schreiben, Ändern und Löschen in den wesentlichen Bereichen (Bereiche `<bereich>:read|write|delete`, 148 weitere Routen und MCP-Werkzeuge), unbegrenzt viele Schlüssel, unbefristete Gültigkeit wählbar, optionale IP-Einschränkung, Step-up beim Anlegen von Schlüsseln mit Änderungsrechten, Löschbestätigung (`X-Clup-Confirm`, `confirm`), Webhooks `post.updated`, `post.deleted`, `announcement.deleted`.

  3. Neuv1.6.0

    Beschlussregister: `GET /ext/organizations/<slug>/decisions` (Bereich `decisions:read`) mit Suche (`q`), Stand (`status`), Zeitraum (`from`, `to`) und Cursor. Mitglieder sehen nur für alle Mitglieder freigegebene Beschlüsse, die Leitung alle; Verantwortliche und interne Notizen liefert die Schnittstelle nie. Neue Webhook-Ereignisse `decision.created` und `decision.updated` (nur Kennungen, nur für freigegebene Beschlüsse) und das MCP-Werkzeug `clup_list_decisions`. Bestehende Aufrufe bleiben unverändert.

  4. Neuv1.5.0

    Aufgabenlisten: `GET /ext/organizations/<slug>/task-lists` und `GET /ext/organizations/<slug>/task-items` (Bereich `tasks:read`), `POST /ext/organizations/<slug>/tasks` nimmt jetzt `listId`, `priority`, `description` und `assigneePublicId` an. Neue Webhook-Ereignisse `task.updated`, `task.completed`, `task.deleted`, `tasklist.created` (nur Kennungen). Neue MCP-Werkzeuge `clup_list_task_lists` und `clup_list_task_items`. Bestehende Aufrufe bleiben unverändert.

  5. 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.

  6. 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.

Versionierung und Änderungsprotokoll · CLUP.life