Technische Dokumentation: alle aktuellen API-Routen, Berechtigungen und Beispiele findest du unter docs.fitsociety.io. Beginne als Entwickler mit dem Public API-Schnellstart.
Funktioniert eine Verbindung mit der öffentlichen API nicht? Die API gibt dann einen HTTP-Status und einen Fehlerschlüssel zurück, zum Beispiel 401 mit auth.invalid_token. Unten liest du, was sie bedeuten. Gib diesen Artikel gern an deinen Entwickler weiter.
Prüfe zuerst Folgendes
Ist der API-Client noch aktiv? Gehe zu Einstellungen → Plugins und Integrationen → Public API → OAuth clients. Steht der Client auf Revoked oder Disabled? Erstelle dann einen neuen Client.
Wurde das Secret erneuert? Nach Rotate secret funktionieren das alte Secret und die aktiven Tokens nicht mehr. Lass deinen Entwickler das neue Secret verwenden.
Ist das Token noch gültig? Ein Zugriffstoken ist eine Stunde gültig. Danach muss die Verbindung ein neues Token anfordern.
Hat der Client die richtigen Scopes? Die Rechte eines bestehenden Clients werden nicht automatisch erweitert. Brauchst du mehr, erstelle einen neuen Client.
Was der Status bedeutet
400: Die Anfrage ist fehlerhaft, zum Beispiel eine ungültige ID oder ein ungültiges Feld. Bei einer Änderung fehlt manchmal der Idempotency-Key (idempotency.required). Der Entwickler passt die Anfrage an.
401: Es gibt kein gültiges Token. auth.missing_bearer: kein Token mitgeschickt. auth.invalid_token: Das Token ist abgelaufen, widerrufen oder falsch. auth.invalid_client: Der API-Client existiert nicht mehr oder ist deaktiviert.
403: Das Token ist gültig, aber es fehlen Rechte. scopes.insufficient: Ein Scope fehlt. scopes.health_consent_required oder scopes.private_communication_consent_required: Der Client wurde ohne Zustimmung zu Gesundheitsdaten oder privater Kommunikation erstellt. auth.provider_unavailable: Die öffentliche API ist für dein Unternehmen nicht verfügbar; wende dich an den Support.
404: Die Adresse oder das Element existiert nicht oder gehört nicht zu deinem Unternehmen.
409: Es gibt einen Konflikt. Zum Beispiel derselbe Idempotency-Key für eine andere Anfrage (idempotency.conflict), eine Anfrage, die noch läuft (idempotency.in_progress), oder ein Mitglied, das schon existiert (CLIENT_ALREADY_EXISTS_IN_COMPANY).
429: zu viele Anfragen (rate_limit.exceeded). Pro API-Client sind 10 Anfragen pro Sekunde erlaubt. Warte die Sekunden aus Retry-After ab und versuche es dann erneut.
500: ein unerwarteter Fehler bei FITsociety (server.internal_error). Versuche es später erneut.
Die öffentliche API gibt keinen Status 422 zurück. Eingabefehler erhalten Status 400.
Fehler beim Anfordern eines Tokens
invalid_client (401): unbekannte Client-ID oder falsches Client Secret.
unauthorized_client (403): Der Client ist deaktiviert oder darf diese Anfrage nicht stellen.
invalid_scope (400): Ein angefragter Scope existiert nicht oder wurde diesem Client nicht erteilt.
invalid_request oder unsupported_grant_type (400): Die Token-Anfrage ist unvollständig oder nutzt eine andere Methode als client_credentials.
Funktioniert es immer noch nicht?
Schick uns über den Chat eine Nachricht mit dem HTTP-Status, dem Fehlerschlüssel, der Uhrzeit und der Request-ID (meta.requestId). Schick nie dein Client Secret oder Zugriffstoken mit.
Die vollständige Liste der Fehlerschlüssel findest du auf docs.fitsociety.io. Lies auch: Eine API-Verbindung einrichten und Rechte verwalten.