Skip to main content
Toutes les erreurs partagent la même forme :
Branchez votre logique sur statusCode, jamais sur message.

​
Codes renvoyés

​
Paramètre invalide
Un paramètre de requête est hors bornes ou mal typé : limit supérieur à 200, offset négatif, valeur non numérique. Les paramètres inconnus sont également refusés plutôt qu’ignorés — une faute de frappe dans un nom de paramètre est signalée au lieu de produire silencieusement un résultat non filtré.
​
Authentification refusée
Voir la section ci-dessous : plusieurs causes distinctes produisent cette même réponse.
​
Ressource absente
L’identifiant demandé n’existe pas, ou appartient à un autre workspace que celui de votre clé. Ces deux cas ne sont pas distingués : les distinguer permettrait de tester l’existence d’un identifiant chez un autre client.
​
Limite de débit
Voir Limites de débit. L’en-tête Retry-After indique le délai d’attente.
​
Incident
Une erreur de notre côté. La requête peut être rejouée. Si elle persiste, transmettez au support le timestamp et le path de la réponse.

​
Pourquoi le 401 ne dit pas ce qui a échoué

Cinq situations différentes renvoient exactement la même réponse :

En-tête absent

Clé inconnue

Clé révoquée

Offre insuffisante

Workspace suspendu

C’est un choix délibéré. Distinguer « clé inconnue » de « clé révoquée » indiquerait à qui balaye des valeurs au hasard lesquelles ont existé ; répondre « offre insuffisante » confirmerait qu’une clé est valide. Le refus est donc uniforme.
Comment diagnostiquer, en pratique. Appelez GET /v1/me avec la clé.
  • Réponse 200 : la clé est bonne, le problème est ailleurs — vérifiez l’URL et les paramètres de l’appel qui échoue.
  • Réponse 401 : ouvrez le panneau des clés dans Administration → Tracking. Si la clé y figure comme active, le blocage vient de l’offre ou de l’état de facturation du workspace, pas de la clé.

​
Ce qu’une erreur ne laisse jamais derrière elle

L’API est en lecture seule : aucun code d’erreur ne correspond à une opération partiellement appliquée. Toute requête en échec peut être rejouée telle quelle, sans risque de doublon.