Aprenda com os códigos de erro mais comuns na API do DeepL. Para obter informações mais detalhadas, consulte a documentação da API do DeepL (disponível em inglês).
Códigos de erro
Erro 400
Bad request. Please check error message and your parameters
Este erro ocorre quando um parâmetro obrigatório do pedido está faltando ou quando um dos parâmetros especificados não é compatível com o pedido, está com erro ortográfico ou o valor está incorreto.
Erro 403
Authorization failed. Please supply a valid auth_key parameter
Este erro ocorre quando a chave de API na solicitação está ausente ou 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 sua assinatura na sua conta DeepL, na seção “Chaves de API”.
Verifique se possui o plano de assinatura correto para o uso que você necessita. Para ter acesso à API do DeepL, é necessário assinar o plano DeepL API. Acesse nossa página de planos e preços para ver quais planos incluem a chave de autenticação para ferramentas CAT.
Erro 404
The requested resource could not be found
Este erro ocorre quando a URL está incorreta. Verifique o caminho da URL.
Erro 413
The request size exceeds the limit
Este erro ocorre quando o tamanho da solicitação atinge o limite compatível com a solicitação.
Consulte a documentação da API para obter informações detalhadas sobre limites de tamanho, especialmente para traduções de ficheiros.
Se estiver tentando traduzir um texto extenso em uma única solicitação de tradução, considere dividi-lo em várias solicitações, p. ex., separando-o por parágrafo.
Erro 414
Request-URL Too Long
Este erro ocorre se as URLs da API forem muito longas e se deve a um limite de comprimento do servidor Web. Você pode evitar esta mensagem de erro utilizando um pedido POST em vez de um pedido GET.
Erro 429
Too many requests. Please wait and resend your request
Ao receber essa resposta, aguarde algum tempo e tente novamente. Se o mesmo erro ocorrer novamente, tente aumentar o intervalo entre as tentativas (p. ex., duplique o tempo de espera). Repita esse procedimento até que a solicitação seja bem-sucedida. Em seguida, você poderá reduzir gradualmente o tempo de espera novamente.
Enviar menos texto em uma única solicitação pode reduzir a probabilidade desse erro.
Erro 456
Quota exceeded. The character limit has been reached
Este erro ocorre quando você atinge o limite de caracteres. Verifique as definições de controle de custos na sua conta DeepL e aumente o limite, se necessário.
Erro 5**
Internal error
Qualquer erro que comece com 5 é um erro interno. Se receber o erro 503, tente aguardar e tente novamente mais tarde. Se receber qualquer outro erro, entre em contato com o atendimento ao cliente DeepL.