Manual · 9
Convenciones
Ruta base
Todos los endpoints están bajo /api/v1 (excepciones: /healthz y la llamada pública a plantillas de documento).
Endpoints de listado: filtro, orden, agrupación, resumen
GET /tables/{id}/records (y la exportación CSV) admiten los mismos parámetros de consulta:
| Parámetro | Significado |
|---|---|
limit |
Tamaño de página, predeterminado 100, máximo 1000 |
offset |
Desplazamiento |
sort |
Columnas separadas por comas, - delante = descendente, p. ej. sort=nombre,-creado_el |
where |
Árbol de filtro JSON, p. ej. {"and":[{"col":"status","op":"eq","val":"activo"}]} |
fields |
devolver solo estas columnas, separadas por comas, p. ej. fields=slug,modificado – también en GET /tables/{id}/records/{pk}. Si solo se piden columnas normales, la base de datos lee solo esas y los campos calculados no se evalúan. Nombre desconocido → 400 invalid_fields. |
group_by |
Columnas separadas por comas, la más externa primero |
summary |
Mapa JSON {"columna":"SUM"} (SUM/COUNT/AVG/MIN/MAX) |
view |
ID de una vista guardada – su filtro/orden/agrupación/resumen se aplican como predeterminados, salvo que los parámetros anteriores los sobrescriban explícitamente |
Formato de respuesta: { "records": [...], "pageInfo": { "limit", "offset", "totalRows", "hasMore" }, "summary": {...} }.
Formato de respuesta en caso de error
{ "error": { "code": "código_corto", "message": "descripción legible para humanos" } }