Limites
Limites de la API: tamano de solicitud, paginacion y cupo. Aqui ves los topes por peticion y por consulta, y como responde la API al superarlos.
Solicitud#
| Limite | Valor |
|---|---|
| Tamano del cuerpo | 2 MiB en emision; 1 MiB en el resto |
| Profundidad JSON | 32 |
Idempotency-Key |
ASCII estable, maximo 128 caracteres |
origenReferencia |
maximo 64 caracteres |
referenciaExterna |
maximo 128 caracteres |
infoAdicional |
hasta 20 objetos |
Un cuerpo mayor responde 413 (codigo 305). Un JSON mas profundo o con
campos desconocidos se rechaza 422 (codigo 302). Un cuerpo mal formado
responde 400 (codigo 301).
Consultas#
| Limite | Valor |
|---|---|
| Rango de fechas | 366 dias |
pagina |
1 a 10000 |
tamanoPagina emitidos |
1 a 100 |
buscar |
100 caracteres |
| Sin fechas | ultimos 30 dias |
Tasa de peticiones#
Los limites de solicitudes y el manejo de la respuesta 429 se explican en
Limite de request.
Cada respuesta de /v1 incluye X-RateLimit-Limit y X-RateLimit-Remaining;
al superar el limite, X-RateLimit-Reset y Retry-After.
Cupo#
Sin documentos disponibles en el ambiente, la emision responde 429
(codigo 501). Consulta el saldo en /v1/consumo.
Excepcion de pruebas#
En el ambiente de pruebas puedes usar una excepcion para ensayar: secuencial de
9 ceros junto con una clave de acceso de 49 ceros. No aplica a produccion.