Häufige Fragen zur Schnittstelle

Kostet die Nutzung der API etwas?

Nein, nicht für Personenschlüssel, Lesen, Exporte und lesendes MCP. Organisationsschlüssel, Schreiben und Webhooks gehören zu Premium (Details).

Wer kann einen Schlüssel anlegen?

Jedes Erwachsenenkonto für sich. Für eine Organisation nur Personen mit Leitungsrecht in dieser Organisation (und Premium). Kinder- und Jugendkonten nie.

Warum bekomme ich 404, obwohl es den Verein gibt?

Weil die Person hinter dem Schlüssel ihn nicht sehen darf oder der Schlüssel an eine andere Organisation gebunden ist. Das ist gewollt: Unsichtbares antwortet nie mit 403, damit sich seine Existenz nicht erraten lässt. Prüfe GET /ext/me auf die Mitgliedschaften und den slug.

Was bedeutet 403 `INSUFFICIENT_SCOPE`?

Dem Schlüssel fehlt der Bereich der Route. Bereiche lassen sich nachträglich nicht ändern: lege einen neuen Schlüssel mit den nötigen Bereichen an.

Warum enthält die Mitgliederliste keine E-Mail-Adressen?

Kontaktdaten sind verschlüsselt und werden bewusst nicht über die Schnittstelle ausgegeben. Das schützt Mitglieder und dich vor ungewollter Weitergabe.

Wie gehe ich mit Zeitzonen um?

Zeitangaben sind ISO 8601 mit Zeitzone (UTC). Rechne für die Anzeige in die Ortszeit deines Vereins um; wiederkehrende Termine werden in Ortszeit gerechnet, damit sie nach der Zeitumstellung nicht um eine Stunde springen.

Warum enthält der Webhook keine Termindaten?

Damit keine personenbezogenen Daten ungeprüft an Dritte fließen. Du holst die Einzelheiten mit deinem Schlüssel ab; dabei gelten die Rechte der Person. Siehe Webhooks.

Gibt es eine Testumgebung (Sandbox)?

Bisher keine eigene Sandbox. Die Konsole arbeitet mit deinem eigenen Schlüssel gegen die Plattform; lesende Aufrufe sind gefahrlos. Teste Schreibzugriffe zuerst mit einem Schlüssel einer Test-Organisation, die du dafür anlegst.

Gibt es OAuth („Mit CLUP.life anmelden“)?

Noch nicht. Aktuell gibt es API-Schlüssel. OAuth 2.1 mit PKCE ist für Dienste vorgesehen, die „Mit CLUP.life verbinden“ anbieten wollen.

Kann ich Beiträge, Spenden oder Rollen über die API ändern?

Nein. Schreibzugriff gibt es nur für Termine, Mitteilungen und Aufgaben — also ohne neuen Personenbezug und ohne Finanz- oder Rechtewirkung.

Support#

Du findest keine Antwort oder etwas verhält sich anders als beschrieben? Wende dich an den Support. Nenne bitte die Route, den HTTP-Status und den code der Antwort — nie deinen Schlüssel.

Status#