La API de consulta REST (
/api/v1) está en acceso anticipado y todavía no está abierta para uso externo. El código existe y el contrato de abajo es el del comportamiento actual. Para consumo externo ahora, use el feed OData.
Acceso anticipado
Contrato documentado para planificación. No construyas integraciones críticas sobre la API REST mientras no se libere.
Devuelve filas paginadas de una tabla de un mart publicado (*_gold/*_silver)
del workspace. Solo lectura, con alcance al workspace.
Resumen#
| Método · ruta | GET /api/v1/tables/{dataset}/{table}?limit=&offset= |
| Base | https://ingestia.io |
| Auth | Clave de API (Authorization: Bearer ing_live_… o ?api_key=) |
| Rol (RBAC) | exportación de datos (member+); clave de datos = owner |
| Costo | cobra por los bytes reales leídos en el datalake (ver abajo) |
| Estados | 200 · 400 · 401 · 403 · 429 · 402 · 502 · 503 |
Parámetros#
| Parámetro | Dónde | Predeterminado | Máx. | Observación |
|---|---|---|---|---|
dataset | ruta | — | — | debe ser {prefixo}_gold o {prefixo}_silver (prefixo = prefijo de tu workspace); si no, 403 |
table | ruta | — | — | solo [A-Za-z0-9_] |
limit | query | 100 | 1000 | filas por página |
offset | query | 0 | — | desplazamiento inicial |
Ejemplo#
curl -H "Authorization: Bearer ing_live_EXEMPLO" \
"https://ingestia.io/api/v1/tables/prd_aurora_gold/vendas?limit=100&offset=0"const url = "https://ingestia.io/api/v1/tables/prd_aurora_gold/vendas?limit=100&offset=0";
const res = await fetch(url, {
headers: { Authorization: "Bearer ing_live_EXEMPLO" },
});
const pagina = await res.json();import requests
res = requests.get(
"https://ingestia.io/api/v1/tables/prd_aurora_gold/vendas",
params={"limit": 100, "offset": 0},
headers={"Authorization": "Bearer ing_live_EXEMPLO"},
)
pagina = res.json()Respuesta 200#
{
"table": "vendas",
"rows": [ { "data": "2026-09-01", "total": 1234.56 } ],
"rowCount": 100,
"nextOffset": 100
}nextOffset es null cuando no hay más páginas. La respuesta incluye el encabezado
x-ingestia-cost-brl (costo proyectado de la llamada).
Costo y paginación#
Paginar una tabla grande es la forma más cara de extraer
LIMIT/OFFSET no reducen los bytes leídos en el datalake — cada página recorre
la tabla. El cobro usa los bytes reales procesados. Para pagar menos,
filtra/agrega con el feed OData (que hace pushdown de
$select/$filter).
Errores#
| Código | Cuándo |
|---|---|
400 | nombre de dataset/tabla inválido |
401 | clave ausente/inválida |
403 | el dataset no es un mart publicado del workspace / rol insuficiente |
429 · 402 | rate limit / pago pendiente |
502 | falla al consultar la tabla en el datalake |
503 | limitador no disponible o datalake no aprovisionado |
Seguridad#
- Solo marts publicados (gold/silver); cualquier otro dataset →
403. - Las columnas PII no se exponen.
- El cobro y el SQL quedan en la auditoría del workspace.
Relacionados#
Última revisión: 2026-09-08.