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 falta um parâmetro obrigatório do pedido ou quando um dos parâmetros especificados não é compatível com o pedido, está mal escrito 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á em falta ou está incorreta.
Para que a chave de API seja válida, a sua assinatura deve estar ativa. Pode verificar a sua chave de API e o estado da sua assinatura na sua conta DeepL, na secção «Chaves de API».
Verifique se possui o plano de assinatura adequado para a utilização que necessita. Para ter acesso à API do DeepL, tem de assinar o plano API do DeepL. Visite a nossa página de planos e preços para ver quais os planos que incluem a chave de autenticação para ferramentas CAT.
Erro 404
The requested resource could not be found
Este erro ocorre quando o URL está incorreto. Verifique o caminho do URL.
Erro 413
The request size exceeds the limit
Este erro ocorre quando o tamanho do pedido atinge o limite compatível com o tamanho do pedido.
Consulte a documentação da API para obter informações detalhadas sobre os limites de tamanho, nomeadamente no que diz respeito à tradução de ficheiros.
Se estiver a tentar traduzir um texto extenso numa única solicitação de tradução, considere dividi-lo em várias solicitações, p. ex., dividindo-o por parágrafo.
Erro 414
Request-URL Too Long
Este erro ocorre se os URLs da API forem demasiado longos e deve-se a um limite de comprimento do servidor Web. 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
Quando receber esta resposta, aguarde algum tempo e tente novamente. Se voltar a obter o mesmo erro, tente aumentar o intervalo entre as tentativas (p. ex., duplique o tempo de espera). Repita este procedimento até que a solicitação seja bem-sucedida. Pode então reduzir gradualmente o tempo de espera novamente.
O envio de menos texto numa única solicitação pode reduzir a probabilidade de este erro ocorrer.
Erro 456
Quota exceeded. The character limit has been reached
Este erro ocorre quando atinge o seu limite de caracteres. Verifique as definições de controlo de custos na sua conta DeepL e aumente o limite, se necessário.
Erro 5**
Internal error
Qualquer erro que comece por 5 é um erro interno. Se receber o erro 503, tente aguardar e volte a tentar mais tarde. Se receber qualquer outro erro, contacte o atendimento ao cliente DeepL.