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
Este contrato está documentado para planificación y transparencia. No construyas integraciones críticas sobre la API REST mientras no se libere. Para leer tablas hoy, prefiere OData.
Lista las tablas de los marts publicados (datasets *_gold y *_silver) del workspace resuelto por la clave de API. Solo lectura, con alcance al workspace.
Resumen#
| Método · ruta | GET /api/v1/tables |
| 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 | R$ 0 (listar el catálogo no genera un job pagado) |
| Estados | 200 · 401 · 403 · 429 · 402 · 503 |
Parámetros#
Ningún parámetro de query. También responde a OPTIONS (preflight CORS) con 204.
Encabezados de respuesta#
X-Ingestia-Access-Scope: workspace(la clave lee el workspace entero).Content-Type: application/json; charset=utf-8.
Ejemplo#
curl -H "Authorization: Bearer ing_live_EXEMPLO" \
https://ingestia.io/api/v1/tablesconst res = await fetch("https://ingestia.io/api/v1/tables", {
headers: { Authorization: "Bearer ing_live_EXEMPLO" },
});
const tabelas = await res.json();import requests
res = requests.get(
"https://ingestia.io/api/v1/tables",
headers={"Authorization": "Bearer ing_live_EXEMPLO"},
)
tabelas = res.json()Respuesta 200#
[
{
"dataset": "prd_aurora_gold",
"table": "vendas",
"layer": "gold",
"columns": [
{ "name": "data", "type": "DATE" },
{ "name": "total", "type": "NUMERIC" }
]
}
]Sin datalake aprovisionado (demo), la ruta devuelve un catálogo claramente simulado para validar la integración — nunca finge datos reales.
Errores#
| Código | Cuándo |
|---|---|
401 | clave ausente/inválida/revocada |
403 | rol/alcance insuficiente (p. ej.: service principal viewer) |
429 | se superó el rate limit (incluye Retry-After) |
402 | workspace con pago pendiente/suspendido |
503 | limitador no disponible (fail-closed) o datalake no aprovisionado |
Formato: { "error": "mensagem em português" } (un mensaje en portugués). Catálogo completo en
Errores y límites.
Seguridad#
- Solo expone marts publicados (gold/silver) — nunca la capa bronze.
- Las columnas marcadas como PII no aparecen en el catálogo.
- Alcance por workspace: la clave nunca resuelve a otro cliente.
Relacionados#
Última revisión: 2026-09-08.