Códigos HTTP
Resumen de los códigos HTTP que devuelve la API de LX CloudPos y la acción recomendada para cada uno. Para la lógica de reintentos, ver estrategias de reintento.
| Código | Significado | ¿Reintentar? | Acción |
|---|---|---|---|
200 | OK | — | Consumir respuesta. |
201 | Creado | — | Comprobante emitido y encolado. |
202 | Aceptado (procesamiento asíncrono) | — | Esperar webhook o hacer polling. |
204 | OK sin cuerpo | — | Operación exitosa. |
400 | Bad Request (validación) | No | Corregir el body. |
401 | Unauthorized | No | Revisar la API key. |
403 | Forbidden | No | Falta el scope requerido. |
404 | Not Found | No | Verificar la clave o el recurso. |
409 | Conflict | No | Idempotency-Key reutilizada con body distinto. |
413 | Payload Too Large | No | Reducir el body por debajo de 256 KB. |
415 | Unsupported Media Type | No | Usar Content-Type: application/json. |
422 | Unprocessable Entity | No | Validación de dominio falló. |
429 | Too Many Requests | Sí | Respetar el header Retry-After. |
500 | Internal Server Error | Sí | Backoff exponencial. |
501 | Not Implemented | No | Funcionalidad no disponible. |
502 | Bad Gateway | Sí | Backoff. |
503 | Service Unavailable | Sí | Backoff agresivo. |
504 | Gateway Timeout | Sí | Backoff. |