Erreurs
Tous les codes d’erreur de l’API et du serveur MCP de findbytown, avec leur statut HTTP et la marche à suivre.
Une erreur a le statut HTTP indiqué ci-dessous et ce corps. error est stable : appuyez-vous dessus, et non sur message, dont la formulation peut changer. Indiquez requestId quand vous nous écrivez ; il figure aussi dans l’en-tête X-Request-Id.
{
"error": "quota_exhausted",
"message": "Monthly reveal quota exhausted.",
"details": {
"resetAt": "2030-01-01T00:00:00.000Z"
},
"requestId": "00000000-0000-4000-8000-000000000000"
}Un 429 porte aussi Retry-After, en secondes. Un 401 porte WWW-Authenticate: Bearer.
| Code | Statut HTTP | Signification |
|---|---|---|
| validation_error | 400 | Un paramètre est manquant ou mal formé. details indique lequel. |
| unknown_parameter | 400 | Un paramètre de requête n’est pas connu de cet endpoint, en général à cause d’une faute de frappe. details indique lequel. |
| use_reveal_endpoint | 400 | Vous avez envoyé reveal= sur une lecture. Les lectures ne consomment jamais de quota : utilisez l’endpoint de révélation. |
| bad_id | 400 | L’identifiant de l’entreprise n’est pas un entier positif. |
| missing_api_key | 401 | En-tête Authorization absent ou vide. |
| invalid_api_key | 401 | La clé n’existe pas ou a été révoquée. |
| quota_exhausted | 402 | Plus aucune révélation disponible pour cette période. details contient la date de réinitialisation. La lecture reste possible. |
| plan_without_api | 403 | L’offre actuelle du compte n’inclut pas l’API. S’applique dès la fin d’une offre. |
| suspended | 403 | Le compte est suspendu. Ses clés refonctionnent si la suspension est levée. |
| bad_origin | 403 | MCP uniquement : l’en-tête Origin du navigateur ne correspond à aucun de nos hôtes. |
| not_found | 404 | Cette entreprise n’existe pas, ou elle a été retirée à la demande de son propriétaire. |
| method_not_allowed | 405 | MCP uniquement : GET et DELETE ne sont pas proposés, utilisez POST. |
| email_invalid | 409 | L’email de cette entreprise est marqué comme invalide, elle ne peut donc pas être révélée. Rien n’a été consommé. |
| payload_too_large | 413 | MCP uniquement : le corps de la requête est trop volumineux. |
| rate_limited | 429 | Trop de requêtes cette minute. Attendez le nombre de secondes indiqué dans Retry-After. |
| budget_exhausted | 429 | Vous avez atteint le budget quotidien d’entreprises distinctes. Les entreprises déjà vues aujourd’hui passent toujours. Retry-After indique quand il se réinitialise. |
| blocked | 429 | L’accès aux données d’entreprises est temporairement suspendu en raison d’un usage automatisé, comme le parcours des identifiants. Retry-After indique le temps restant. Écrivez au support s’il s’agit d’une erreur. |
| internal_error | 500 | Une erreur s’est produite de notre côté. Indiquez requestId en écrivant au support. |
| reveals_unavailable | 503 | Les révélations sont brièvement indisponibles et rien n’a été consommé. Réessayez dans quelques instants. |