Manejar errores sin perder el contexto de la solicitud.
{
"text": "Contenido fuente complejo en el idioma seleccionado.",
"locale": "es",
"mode": "simple-language"
}Ejemplos de SDK y cURL disponibles
Mensajes de error uniformes
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}La mayoría de los errores usan la estructura error anterior. Las respuestas de límite de velocidad también incluyen los campos de nivel superior limit, remaining y reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Para los límites de velocidad HTTP 429, espera el tiempo indicado en la cabecera Retry-After. allowance_exhausted incluye en su lugar error.details.used, limit y periodEndsAt.
Códigos de error
Estos códigos de error utilizan la versión API 2:
| HTTP | Código | Significado | Acción del cliente |
|---|---|---|---|
| 400 | invalid_json | El cuerpo de la solicitud no es JSON válido. | Corregir el cuerpo JSON |
| 400 | invalid_request | Falta un campo, es desconocido o no es válido, o el texto supera los 5.000 caracteres | Correcta la solicitud |
| 400 | clave_idempotencia_inválida | Una solicitud de trabajo o lote no tiene una clave de idempotencia válida | Enviar una clave única de como máximo 255 caracteres |
| 400 | invalid_webhook_endpoint | El punto final del webhook seleccionado falta o está inactivo | Elija un punto final activo o utilice el sondeo |
| 401 | clave_api_inválida | El token de portador falta, no es válido o está revocado | Verifique o reemplace la clave API |
| 402 | facturación_requerida | La facturación debe actualizarse antes de que el procesamiento pueda continuar | Actualizar facturación en la aplicación |
| 403 | feature_not_available | El espacio de trabajo no tiene ningún derecho activo | Elige un plan o contacta con soporte |
| 403 | correo electrónico_no_verificado | No se verifica ningún correo electrónico de propietario o administrador. | Verificar un correo electrónico de cuenta elegible |
| 404 | trabajo_no_encontrado | El trabajo no existe, pertenece a otro espacio de trabajo o ha caducado | Detener la consulta de estado e iniciar una nueva orden si es necesario |
| 404 | lote_no_encontrado | El lote no existe, pertenece a otro espacio de trabajo o ha caducado | Deje de sondear y cree un nuevo lote si es necesario |
| 429 | tasa_limitada | Se ha alcanzado la tasa de solicitudes | Respetar después de intentarlo |
| 429 | concurrency_limit | Se están procesando demasiadas solicitudes al mismo tiempo | Reintentar después de que finalice una solicitud activa |
| 429 | allowance_exhausted | Se alcanzó el límite mensual de caracteres y el uso adicional no está disponible o está deshabilitado | Espere al próximo período de facturación o habilite el uso adicional en un plan elegible |
| 502 | procesamiento_fallido | El servicio no pudo procesar el texto. | Repita la solicitud y contacte al soporte con el ID de la solicitud si el problema continúa. |
Documente cada error: ¿Puede repetirse la solicitud? ¿Se cuentan los signos? ¿Qué dice el protocolo? ¿qué información necesita el soporte?