Aprenda sobre 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 necessário para o pedido ou quando um dos parâmetros especificados não é suportado, está mal escrito ou tem o valor errado.
Erro 403
Authorization failed. Please supply a valid auth_key parameter
Este erro ocorre quando a chave de API está em falta no pedido ou é incorreta.
Para que a chave de API seja válida, a sua assinatura tem de estar ativa. Pode verificar a sua chave de API e o estado da sua assinatura na sua conta DeepL, em "Chaves de API".
Verifique se possui o plano de assinatura correto para o uso que necessita. Para obter acesso à API do DeepL, é necessário assinar o plano API do DeepL. Visite a 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 o URL está errado. 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.
Consulte a documentação da API para obter informações detalhadas sobre limites de tamanho, especialmente para traduções de documentos.
Se estiver a tentar traduzir um texto grande num único pedido de tradução, considere dividi-lo em vários pedidos, por exemplo, por parágrafo.
Erro 414
Request-URL Too Long
Este erro ocorre se os URL da API forem demasiado longos e deve-se a um limite de comprimento do servidor Web. Pode evitar este erro utilizando um pedido POST em vez de um pedido GET.
Erro 429
Too many requests. Please wait and resend your request
Quando obtiver esta resposta, aguarde algum tempo e tente novamente. Se o erro persistir, tente aguardar mais tempo entre as tentativas (p. ex., duplique o tempo de espera). Repita este processo até que o pedido seja bem‑sucedido. Poderá então voltar a reduzir gradualmente o tempo de espera.
O envio de menos texto num único pedido tende a reduzir a probabilidade de ocorrência deste erro.
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 com o número 5 é um erro interno. Se receber o erro 503, aguarde e tente novamente mais tarde. Se receber qualquer outro erro, entre em contacto com o atendimento ao cliente DeepL.