DocumentationAPI & MCP

Erreurs et limites

Les codes d'erreur, ce qu'ils veulent dire, et combien d'appels par minute.

Une erreur répond { "error": { "code": "…", "message": "…" } } avec son statut HTTP. Via MCP, le message de l'erreur d'outil est CODE: message. Fiez-vous au code, pas au message.

Codes d'erreur

StatutCodeQuand
400INVALID_INPUTLe corps ou un argument ne correspond pas à l'opération : details liste les champs en cause.
401MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETEDPas de clé, une clé inconnue ou révoquée, une clé expirée, ou son espace a été supprimé.
402INSUFFICIENT_TOKENSUne opération facturée, que les crédits de l'espace ne peuvent pas payer.
403FORBIDDENLe créateur de la clé n'a pas le droit de faire cela dans l'espace : la même règle que dans l'app.
403PLAN_LIMIT_EXCEEDEDLe plan de l'espace ne le comprend pas : sur un compte qui n'a jamais payé, les liens entrants d'un concurrent ou l'analyse d'un concurrent masqué.
404NOT_FOUNDCe site, cette conversation, cette tâche… n'existe pas dans cet espace.
409CONFLICTDéjà en cours, ou dans un état qui l'interdit.
429RATE_LIMITEDTrop de requêtes pour l'espace : Retry-After indique quand réessayer.
503SERVICE_UNAVAILABLEUn service dont l'opération a besoin est brièvement indisponible : réessayez plus tard.
500INTERNAL_ERRORUne erreur de notre côté : réessayez plus tard.
402
{
  "error": {
    "code": "INSUFFICIENT_TOKENS",
    "message": "Workspace is out of tokens for this period."
  }
}

Limites de débit

Par espace
API120 requêtes par minute
MCP30 appels d'outils par minute

Au-delà de la limite, la réponse est 429 RATE_LIMITED, avec un en-tête Retry-After qui indique quand réessayer.

Une question sans réponse ici ? Écrivez-nous.

Prêt à faire décoller votre site ?

Posez votre première question - semchat vous répond avec un plan d'action clair, en quelques secondes.

Gratuit · sans inscription · en 5 secondes