Base URL
/v1/cep/*. Las rutas de gestión (/keys, /admin/*) usan sesión de Supabase y no son consumibles desde código de cliente.
Autenticación
Convenciones
| Encoding | UTF-8 |
| Content-Type request | application/json |
| Errores | JSON { error, message, details? } — ver Errores |
| Versionado | Prefijo /v1. Cambios breaking subirán a /v2. |
| Idempotencia | Las descargas son seguras de reintentar; el CEP es inmutable por (fecha, clave_rastreo, monto). |
| Timeout sugerido | 15s por request |
Tipos de endpoints CEP
Modo explícito
/v1/cep/{xml,pdf,base64,xml_base64} — requieren emisor y receptor (códigos Banxico de 5 dígitos).Modo auto
/v1/cep/{xml,pdf,zip}_auto — infieren emisor/receptor desde la cuenta. Ver Inferencia.Headers de respuesta útiles
| Header | Significado |
|---|---|
X-Inferred-Emisor | Código Banxico inferido (sólo _auto) |
X-Inferred-Receptor | Código Banxico inferido (sólo _auto) |
X-Date-Used | Fecha exacta consultada en Banxico |
X-Attempts | Intentos realizados antes del hit |
X-Request-Id | ID único del request, úsalo al contactar soporte |