Technische documentatie: alle actuele API-routes, rechten en voorbeelden staan op docs.fitsociety.io. Begin als ontwikkelaar bij de Public API-snelstart.
Werkt een koppeling met de publieke API niet? De API geeft dan een HTTP-status en een foutsleutel, bijvoorbeeld 401 met auth.invalid_token. Hieronder lees je wat ze betekenen. Geef dit artikel gerust door aan je ontwikkelaar.
Controleer dit eerst
Is de API-client nog actief? Ga naar Instellingen → Plug-ins en integraties → Public API → OAuth-clients. Staat de client op Ingetrokken of Uitgeschakeld? Maak dan een nieuwe client.
Is het secret vernieuwd? Na Secret vernieuwen werken het oude secret en de actieve tokens niet meer. Laat je ontwikkelaar het nieuwe secret gebruiken.
Is het token nog geldig? Een toegangstoken is één uur geldig. Daarna moet de koppeling een nieuw token aanvragen.
Heeft de client de juiste scopes? Rechten van een bestaande client worden niet vanzelf uitgebreid. Heb je meer nodig, maak dan een nieuwe client.
Wat de status betekent
400: het verzoek klopt niet, bijvoorbeeld een ongeldig ID of veld. Bij een wijziging ontbreekt soms de Idempotency-Key (idempotency.required). De ontwikkelaar past het verzoek aan.
401: er is geen geldig token. auth.missing_bearer: geen token meegestuurd. auth.invalid_token: het token is verlopen, ingetrokken of onjuist. auth.invalid_client: de API-client bestaat niet meer of is uitgeschakeld.
403: het token is geldig, maar er ontbreken rechten. scopes.insufficient: een scope ontbreekt. scopes.health_consent_required of scopes.private_communication_consent_required: de client is gemaakt zonder toestemming voor gezondheidsgegevens of privécommunicatie. auth.provider_unavailable: de publieke API is niet beschikbaar voor je bedrijf; neem contact op met support.
404: het adres of het item bestaat niet, of hoort niet bij jouw bedrijf.
409: er is een botsing. Bijvoorbeeld dezelfde Idempotency-Key voor een ander verzoek (idempotency.conflict), een verzoek dat nog loopt (idempotency.in_progress), of een lid dat al bestaat (CLIENT_ALREADY_EXISTS_IN_COMPANY).
429: te veel verzoeken (rate_limit.exceeded). Per API-client mogen er 10 verzoeken per seconde zijn. Wacht het aantal seconden uit Retry-After en probeer het dan opnieuw.
500: een onverwachte fout bij FITsociety (server.internal_error). Probeer het later opnieuw.
De publieke API geeft geen status 422. Fouten in de invoer krijgen status 400.
Fouten bij het aanvragen van een token
invalid_client (401): onbekend client-ID of verkeerd client secret.
unauthorized_client (403): de client is uitgeschakeld of mag deze aanvraag niet doen.
invalid_scope (400): een gevraagde scope bestaat niet of is niet aan deze client gegeven.
invalid_request of unsupported_grant_type (400): het tokenverzoek is onvolledig of gebruikt een andere methode dan client_credentials.
Werkt het nog steeds niet?
Stuur ons een bericht via de chat met de HTTP-status, de foutsleutel, het tijdstip en het request-ID (meta.requestId). Stuur nooit je client secret of toegangstoken mee.
De volledige lijst met foutsleutels staat op docs.fitsociety.io. Lees ook: Een API-koppeling instellen en rechten beheren.