Importante: Para informações mais detalhadas, consulte a Documentação da API do DeepL. A documentação da API está disponível apenas em inglês.
Exemplos de códigos de erro
Erro 400
Solicitação ruim. Please check error message and your parameters
Este erro ocorre quando falta um parâmetro requerido no pedido ou um dos parâmetros especificados não é compatível, está mal escrito ou tem o valor errado.
Erro 403
A autorização falhou. Please supply a valid auth_key parameter
Este erro ocorre quando a chave de API no pedido está faltando ou está incorreta.
Para que a chave de API seja válida, sua assinatura deve estar ativa. Você pode verificar sua chave de API e o status da assinatura na sua conta DeepL, em Chaves de API.
Verifique também se o seu plano de assinatura dá direito a utilizar os serviços que você deseja. Para obter acesso à API do DeepL, você precisa assinar o plano de API do DeepL. A chave de autenticação para as ferramentas CAT está incluída nos planos de assinatura DeepL Pro Advanced e DeepL Pro Ultimate.
Erro 404
O recurso solicitado não pôde ser encontrado
Este erro ocorre quando o endereço eletrônico (URL) está errado. Verifique o caminho do URL.
Erro 413
O tamanho da solicitação excede o limite
Esse erro ocorre quando o tamanho da solicitação atinge o limite suportado.
Consulte a Documentação da API para informações detalhadas sobre limites de tamanho, sobretudo para traduções de documentos.
Se você estiver tentando traduzir um texto muito grande em um único pedido de tradução, tente dividi-lo em partes menores como, por exemplo, em parágrafos e, em seguida, refaça o pedido para tradução.
Erro 414
Request-URI muito longo
Este erro ocorre quando as URLs da API são muito longas e se deve a um limite de comprimento do servidor web. Você pode evitar este erro usando uma solicitação POST ao invés de uma solicitação GET.
Erro 429
Muitas solicitações. Please wait and resend your request
Quando você receber esta resposta, aguarde algum tempo e tente novamente. Se, ainda assim, você receber o mesmo erro novamente, aguarde mais tempo entre uma tentativa e outra (aguarde o dobro do tempo, por exemplo). Repita isto até que a solicitação seja atendida. Em seguida, você pode ir reduzindo gradativamente o tempo de espera entre uma solicitação e outra.
O envio de textos menores em um único pedido pode reduzir a probabilidade deste erro.
Erro 456
Cota excedida. The character limit has been reached
Este erro ocorre quando você atinge seu limite de caracteres. Verifique as configurações de controle de custos na sua conta DeepL e aumente o limite, se necessário.
Erro 5**
Erro interno
Qualquer erro que comece com o número 5 é um erro interno. Se você receber um erro 503, aguarde e tente novamente mais tarde. Se receber qualquer outro erro, entre em contato com o serviço de atendimento ao cliente DeepL.