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
Envelope de erro
O envelope de erro de produção da Versão 2 contém um objeto de erro com código estável e campos de mensagem.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}O objeto de detalhes opcional carrega contexto legível por máquina, como retryAfterSeconds.
Os cabeçalhos de resposta HTTP transportam autenticação e repetem metadados quando aplicável.
Catálogo de erros exigidos
Os códigos a seguir são o contrato atual da 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 10.000 caracteres | Corrigir a solicitação |
| 400 | invalid_idempotency_key | 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 | assinatura_requerida | 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 | Pare de pesquisar e crie um novo trabalho, 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 simultaneidade | 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 | Tente novamente com segurança e entre em contato com o suporte com o ID da solicitação se continuar |
Para cada erro, capacidade de repetição de documentos, efeito de faturamento, visibilidade de log e informações de suporte.