DocumentaçãoAPI e MCP

Erros e limites

Os códigos de erro, o que eles significam e quantas chamadas por minuto.

Um erro responde { "error": { "code": "…", "message": "…" } } com o status HTTP dele. Pelo MCP, a mensagem do erro da ferramenta é CODE: message. Use o código para decidir, não a mensagem.

Códigos de erro

StatusCódigoQuando
400INVALID_INPUTO corpo ou um argumento não corresponde à operação: details lista os campos com problema.
401MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETEDSem chave, uma chave desconhecida ou revogada, uma chave expirada, ou o espaço de trabalho dela foi excluído.
402INSUFFICIENT_TOKENSUma operação cobrada, e os créditos do espaço de trabalho não conseguem pagá-la.
403FORBIDDENQuem criou a chave não tem permissão para fazer isso no espaço de trabalho: a mesma regra do aplicativo.
403PLAN_LIMIT_EXCEEDEDO plano do espaço de trabalho não inclui isso: em uma conta que nunca pagou, os backlinks de um concorrente ou a análise de um concorrente oculto.
404NOT_FOUNDEsse site, conversa, tarefa… não existe neste espaço de trabalho.
409CONFLICTJá está em andamento, ou em um estado que não permite isso.
429RATE_LIMITEDRequisições demais para o espaço de trabalho: Retry-After diz quando tentar de novo.
503SERVICE_UNAVAILABLEUm serviço de que a operação precisa está indisponível no momento: tente mais tarde.
500INTERNAL_ERRORA culpa é nossa: tente mais tarde.
402
{
  "error": {
    "code": "INSUFFICIENT_TOKENS",
    "message": "Workspace is out of tokens for this period."
  }
}

Limites de requisições

Por espaço de trabalho
API120 requisições por minuto
MCP30 chamadas de ferramentas por minuto

Acima do limite, a resposta é 429 RATE_LIMITED, com um cabeçalho Retry-After que diz quando tentar de novo.

Não encontrou a resposta? Fale com a gente.

Pronto para fazer seu site decolar?

Faça sua primeira pergunta - o semchat responde com um plano de ação claro em segundos.

Grátis · sem cadastro · em 5 segundos