Todo erro usa a mesma estrutura JSON, então um único manipulador cobre todos.
{
"error": {
"code": "forbidden",
"message": "this API key is missing the \"write\" scope"
}
}
Códigos de status
| Status | code | Quando |
|---|---|---|
| 400 | validation_error | O corpo ou a query falhou na validação. error.fields nomeia cada campo |
| 401 | unauthorized | A chave está ausente, é inválida, foi revogada ou está desativada |
| 402 | plan_limit | Seu plano não inclui isso, ou um limite do plano foi atingido |
| 403 | forbidden | A chave não tem o escopo necessário para este endpoint |
| 404 | not_found | O recurso não existe neste workspace |
| 429 | rate_limited | Muitas solicitações desta chave |
| 500 | internal_error | Algo deu errado do nosso lado. Tente novamente com backoff |
Limites de taxa
Cada chave pode fazer 120 solicitações a cada 60 segundos, compartilhadas entre a API REST e o servidor MCP. As respostas incluem os cabeçalhos padrão RateLimit e RateLimit-Policy, para que você possa desacelerar antes de atingir o limite.
Boa prática
- Tente novamente respostas
429e5xxcom backoff exponencial. Não tente novamente erros4xxalém de429. - Mantenha as chaves no seu servidor. Nunca as inclua em um navegador ou aplicativo móvel.
- Use uma chave separada por aplicativo, para que você possa rotacionar ou revogar uma sem afetar as outras.
Isso foi útil?
Publique posts alinhados à sua marca em minutos
Voltar à documentaçãoConteúdo de IA, agendamento, interação e um pacote completo de marketing — grátis para começar.
Comece grátis
