FITsociety Help FR

Résoudre les messages d'erreur de l'API

3 min de lecture

Documentation technique : toutes les routes API, autorisations et exemples à jour se trouvent sur docs.fitsociety.io. Pour les développeurs, commence par le guide de démarrage rapide de la Public API.

Une connexion avec l'API publique ne fonctionne pas ? L'API renvoie alors un statut HTTP et une clé d'erreur, par exemple 401 avec auth.invalid_token. Tu lis ci-dessous ce qu'ils signifient. N'hésite pas à transmettre cet article à ton développeur.

Vérifie d'abord ceci

  1. Le client API est-il toujours actif ? Va dans Paramètres → Plugins et intégrations → Public API → OAuth clients. Le client est sur Revoked ou Disabled ? Crée alors un nouveau client.

  2. Le secret a-t-il été renouvelé ? Après Rotate secret, l'ancien secret et les jetons actifs ne fonctionnent plus. Demande à ton développeur d'utiliser le nouveau secret.

  3. Le jeton est-il encore valide ? Un jeton d'accès est valable une heure. Ensuite, la connexion doit demander un nouveau jeton.

  4. Le client a-t-il les bons scopes ? Les droits d'un client existant ne sont pas étendus automatiquement. S'il t'en faut plus, crée un nouveau client.

Ce que signifie le statut

  • 400 : la requête est incorrecte, par exemple un identifiant ou un champ invalide. Pour une modification, l'Idempotency-Key manque parfois (idempotency.required). Le développeur corrige la requête.

  • 401 : aucun jeton valide. auth.missing_bearer : aucun jeton envoyé. auth.invalid_token : le jeton est expiré, révoqué ou incorrect. auth.invalid_client : le client API n'existe plus ou est désactivé.

  • 403 : le jeton est valide, mais des droits manquent. scopes.insufficient : un scope manque. scopes.health_consent_required ou scopes.private_communication_consent_required : le client a été créé sans consentement pour les données de santé ou les communications privées. auth.provider_unavailable : l'API publique n'est pas disponible pour ton entreprise ; contacte le support.

  • 404 : l'adresse ou l'élément n'existe pas, ou n'appartient pas à ton entreprise.

  • 409 : il y a un conflit. Par exemple la même Idempotency-Key pour une autre requête (idempotency.conflict), une requête encore en cours (idempotency.in_progress), ou un membre qui existe déjà (CLIENT_ALREADY_EXISTS_IN_COMPANY).

  • 429 : trop de requêtes (rate_limit.exceeded). Chaque client API peut envoyer 10 requêtes par seconde. Attends le nombre de secondes indiqué dans Retry-After, puis réessaie.

  • 500 : une erreur inattendue chez FITsociety (server.internal_error). Réessaie plus tard.

L'API publique ne renvoie pas de statut 422. Les erreurs de saisie reçoivent le statut 400.

Erreurs lors de la demande d'un jeton

  • invalid_client (401) : identifiant client inconnu ou secret client incorrect.

  • unauthorized_client (403) : le client est désactivé ou n'a pas le droit de faire cette demande.

  • invalid_scope (400) : un scope demandé n'existe pas ou n'a pas été attribué à ce client.

  • invalid_request ou unsupported_grant_type (400) : la demande de jeton est incomplète ou utilise une autre méthode que client_credentials.

Ça ne fonctionne toujours pas ?

Envoie-nous un message via le chat avec le statut HTTP, la clé d'erreur, l'heure et l'identifiant de requête (meta.requestId). N'envoie jamais ton secret client ni ton jeton d'accès.

La liste complète des clés d'erreur se trouve sur docs.fitsociety.io. Lis aussi : Configurer une connexion API et gérer les droits.

Cet article vous a-t-il été utile ? Merci pour votre retour !

Merci, nous lisons chaque commentaire.

Articles liés