Errores
internal_error
Algo falló de nuestro lado. No se emitió nada.
Algo falló de nuestro lado. No se emitió nada.
| Código | internal_error |
| Tipo | api_error — Falla nuestra |
| HTTP | 500 |
| ¿Reintentable? | Sí |
Qué hacer
Reintenta con backoff y la MISMA Idempotency-Key. Cita el request_id si persiste.
Reintentar el mismo request puede funcionar. Respeta Retry-After cuando venga.
El sobre
{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "…",
"hint": "Retry with backoff and the SAME `Idempotency-Key`. Quote the `request_id` if it persists.",
"retriable": true,
"doc_url": "https://docs.facturia.cl/errors/internal_error",
"request_id": "req_01K2R7Q9M4T2VB"
}
}Programa contra code, nunca contra message — la prosa se puede reescribir, el código no (§5.8).
hint y retriable llegan en la respuesta, con estos mismos valores: son función del code y salen del mismo diccionario que sirve GET /v1/error_codes, así que el sobre y el diccionario no pueden discrepar. hint va en inglés a propósito — el español de este código es esta ficha. Más en El sobre de error.
También
Todos los códigos
La tabla completa, agrupada por dónde te la vas a encontrar.
El sobre de error
Los nueve tipos, el request_id y cómo manejarlos en la práctica.
La copia legible por máquina de esta ficha vive en GET /v1/error_codes, sin autenticación.