Formato de las respuestas
Todo lo exitoso viene envuelto en data; los listados agregan meta.
Todo lo exitoso va envuelto en data:
{ "data": { "…": "…" } }Las respuestas paginadas agregan meta:
{
"data": ["…"],
"meta": {
"page": 1,
"limit": 50,
"total": 213,
"totalPages": 5,
"hasNextPage": true
}
}Campo de meta | Notas |
|---|---|
page | Página devuelta, empezando en 1 |
limit | Tamaño de página aplicado |
total | Total de elementos que cumplen el filtro, no de la página |
totalPages | ceil(total / limit) |
hasNextPage | true si existe una página siguiente. Es lo que conviene usar para el bucle de paginación |
Los endpoints paginados aceptan page (desde 1) y limit (default 20, máximo
100).
Cada respuesta trae el header X-Request-Id. Guardalo en tus logs: con ese
único dato ubicamos tu petición exacta si necesitás soporte.
Podemos agregar campos nuevos a las respuestas sin previo aviso; eso no se considera un cambio incompatible. Tu cliente debe ignorar los que no conozca. Ver Compatibilidad y cambios.