En este artículo:
Importante: Para obtener información más detallada, consulta la documentación de la API de DeepL. La documentación de la API sólo está disponible en inglés.
Ejemplos de códigos de error:
Error 400
Mala petición. Please check error message and your parameters (Petición incorrecta. Comprueba el mensaje de error y tus parámetros).
Este error ocurre cuando falta uno de los parámetros requeridos para la petición o cuando uno de los parámetros que has especificado no es compatible, está mal escrito o tiene un valor incorrecto.
Error 403
Autorización fallida. Please supply a valid auth_key parameter (Autorización fallida. Por favor, introduce un parámetro auth_key válido).
Este error ocurre cuando falta la clave de API en la petición o es incorrecta.
Para que la clave de API sea válida, tu suscripción tiene que estar activa. Puedes consultar tu clave de API y el estado de tu suscripción en tu cuenta de DeepL, desde la pestaña Claves de API.
Asegúrate de que has elegido el plan de suscripción correcto para los servicios que quieres. Para tener acceso a la API de DeepL, necesitas una suscripción a uno de los planes DeepL API. La clave de autenticación para herramientas TAO está incluida en los planes DeepL Pro Advanced y DeepL Pro Ultimate.
Error 404
No se ha podido encontrar el recurso solicitado
Este error ocurre cuando la URL es incorrecta. Comprueba la ruta de la URL.
Error 413
El tamaño de la solicitud supera el límite
Este error ocurre cuando el tamaño de la petición alcanza el límite permitido.
Para obtener información detallada acerca de los límites de tamaño, especialmente para las traducciones de documentos, consulta la documentación de la API.
Si estás intentando traducir un texto largo en una sola petición de traducción, intenta dividirlo en varias peticiones, p. ej., por párrafos.
Error 414
Request-URI demasiado largo
Este error ocurre cuando las URL de la API son demasiado largas y se debe a un límite de longitud en el servidor web. Para evitar este error, usa una petición POST en lugar de una petición GET.
Error 429
Demasiadas peticiones. Please wait and resend your request (Demasiadas peticiones. Por favor, espera y vuelve a enviar tu petición).
Si recibes esta respuesta, espera un tiempo y vuelve a intentarlo. Si, aun así, vuelves a recibir el error, espera durante más tiempo antes de intentarlo de nuevo (p. ej., espera el doble de tiempo que la primera vez). Repite el proceso hasta que la petición funcione. Después podrás reducir gradualmente el tiempo de espera de nuevo.
Enviar menos texto por petición puede contribuir a evitar la posibilidad de recibir este error.
Error 456
Cuota superada. The character limit has been reached (Cuota excedida. Se ha alcanzado el límite de caracteres).
Este error ocurre cuando has alcanzado el límite de caracteres. Comprueba la configuración del control de costes desde tu cuenta de DeepL y aumenta el límite si fuera necesario.
Error 5**
Error interno
Cualquier código de error que empiece con un 5 es un error interno. Si recibes un error 503, espera y vuelve a intentarlo más tarde. Si recibes cualquier otro error, contacta con el servicio de atención al cliente de DeepL.