> ## Documentation Index
> Fetch the complete documentation index at: https://docs.otbstudio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Erreurs

> Les codes d'erreur et statuts HTTP de l'API REST d'OTB Studio, leur signification et la marche à suivre, et la façon dont le serveur MCP signale les échecs.

En REST, chaque erreur est `{"code":"…"}` et rien d'autre : un code stable, jamais une phrase, pour que vous puissiez le traduire pour vos propres utilisateurs. Le [serveur MCP](/fr/mcp.md#erreurs-et-limites) renvoie plutôt une recherche sans résultat comme un résultat normal ; seuls `401` et `429` parviennent à un client MCP sous forme de statut.

| Code | Statut | Signification | Que faire |
| - | - | - | - |
| `missing_token` | 401 | Pas d'en-tête `Authorization: Bearer` | Envoyez votre clé API |
| `invalid_token` | 401 | Clé inconnue, mal formée ou révoquée | Vérifiez la clé, ou créez-en une nouvelle |
| `query_required` | 400 | `GET /v1/companies` sans `q` | Ajoutez un terme de recherche |
| `insufficient_credits` | 402 | Pas de formule, ou le solde ne couvre pas cette réponse | Choisissez une formule ou ajoutez des crédits sur [app.otbstudio.ai](https://app.otbstudio.ai) |
| `not_found` | 404 | Entreprise introuvable pour ce numéro d'entreprise, ou aucune route ne correspond à ce chemin | Vérifiez le numéro ou le chemin |
| `method_not_allowed` | 405 | Le chemin existe, mais pas avec cette méthode | Chaque route de données est un `GET` |
| `rate_limited` | 429 | Débit de l'organisation dépassé, ou trop d'appels simultanés | Réessayez après `Retry-After` secondes |
| `internal` | 500 | Une erreur de notre côté | Réessayez ; chaque route de données est une lecture sûre et idempotente |
| `busy` | 503 | Les données n'ont pas pu être lues dans les 15 secondes | Réessayez après `Retry-After` secondes |

Sur un `402`, `X-Credits-Cost` et `X-Credits-Remaining` indiquent de combien le solde était insuffisant. Lorsque l'appel a été refusé avant son exécution (pas de formule, ou solde nul), `X-Credits-Cost` vaut `0`, car le prix n'est pas encore connu.

Les routes de compte qu'utilise le tableau de bord ont d'autres codes. Elles ne font pas partie d'une intégration de données.

Vous êtes bloqué ? Écrivez à [engineering@otbstudio.ai](mailto:engineering@otbstudio.ai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.