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
Envase de error
El sobre de error de producción de la Versión 2 contiene un objeto de error con código estable y campos de mensaje.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}El objeto de detalles opcional incluye un contexto legible por máquina, como retryAfterSeconds.
Los encabezados de respuesta HTTP llevan metadatos de autenticación y reintento cuando corresponda.
Catálogo de errores requeridos
Los siguientes códigos son el contrato actual de la Versión 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 10.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 | suscripción_requerida | 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 | Deje de sondear y cree un nuevo trabajo 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 | límite_concurrencia | Se están procesando demasiadas solicitudes al mismo tiempo | Reintentar después de que finalice una solicitud activa |
| 429 | asignación_agotada | 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. | Vuelva a intentarlo de forma segura y comuníquese con el soporte con el ID de la solicitud si continúa |
Para cada error, reintento de documentos, efecto de facturación, visibilidad de registros e información de soporte.