Manusear erros sem perder o contexto da solicitação.
{
"text": "Conteúdo de origem complexo no idioma selecionado.",
"locale": "pt",
"mode": "simple-language"
}Exemplos de SDK e cURL disponíveis
Mensagens de erro uniformes
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}A maioria dos erros usa a estrutura error acima. As respostas de limite de taxa também incluem os campos de nível superior limit, remaining e reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Para limites de taxa HTTP 429, aguarda de acordo com o cabeçalho Retry-After. allowance_exhausted inclui, em vez disso, error.details.used, limit e periodEndsAt.
Códigos de falha
Estes códigos de erro usam API versão 2:
| HTTP | Código | Significação | Ação do cliente |
|---|---|---|---|
| 400 | invalid_json | O corpo da solicitação não é JSON válido | Corrija o corpo JSON |
| 400 | invalid_request | Um campo está faltando, é desconhecido ou inválido ou o texto excede 5.000 caracteres | Corrigir a solicitação |
| 400 | idempotency_key_required | Uma solicitação de trabalho ou lote não possui chave de idempotência válida | Envie uma chave exclusiva de no máximo 255 caracteres |
| 400 | invalid_webhook_endpoint | O endpoint do webhook selecionado está ausente ou inativo | Escolha um endpoint ativo ou use polling |
| 401 | invalid_api_key | O token do portador está ausente, é inválido ou foi revogado | Verifique ou substitua a chave API |
| 402 | faturamento_requerido | O faturamento precisa ser atualizado antes que o processamento possa continuar | Atualizar faturamento no aplicativo |
| 403 | subscrição necessária | O espaço de trabalho não tem direitos ativos | Escolha um plano ou entre em contato com o suporte |
| 403 | email_not_verified | Nenhum e-mail de proprietário ou administrador foi verificado | Verifique um e-mail de conta qualificado |
| 404 | trabalho_não_encontrado | O trabalho não existe, pertence a outro espaço de trabalho ou expirou | Parar a consulta de status e iniciar uma nova ordem, se necessário |
| 404 | lote_não_encontrado | O lote não existe, pertence a outro espaço de trabalho ou expirou | Pare de pesquisar e crie um novo lote, se necessário |
| 429 | taxa_limitada | A taxa de solicitação foi atingida | Respeito depois de tentar |
| 429 | limite de concorrência | Muitas solicitações estão sendo processadas ao mesmo tempo | Tentar novamente após a conclusão de uma solicitação ativa |
| 429 | subsídio esgotado | O limite mensal de caracteres foi atingido e o uso adicional está indisponível ou desativado | Aguarde o próximo período de faturamento ou ative o uso adicional em um plano qualificado |
| 502 | processamento_falido | O serviço não conseguiu processar o texto | Repita o suporte de solicitação e contato com o ID de solicitação se o problema persistir |
Documento para cada erro: A solicitação pode ser repetida? Os sinais são calculados? O que está em acta? Que informação precisa de apoio?