El service document es la puerta de entrada del feed OData v4: lista una
entidad por cada tabla publicada (*_gold/*_silver) del workspace. Power BI y Excel
descubren los feeds a partir de aquí.
Resumen#
| Método · ruta | GET /api/v1/odata |
| 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 (descubrir entidades no genera un job pagado) |
| Encabezados | OData-Version: 4.0 · X-Ingestia-Access-Scope: workspace |
| Estados | 200 · 401 · 403 · 429 · 402 · 503 |
Parámetros#
Ninguno. También responde a OPTIONS (preflight CORS).
Ejemplo#
curl -H "Authorization: Bearer ing_live_EXEMPLO" \
https://ingestia.io/api/v1/odataconst res = await fetch("https://ingestia.io/api/v1/odata", {
headers: { Authorization: "Bearer ing_live_EXEMPLO" },
});
const servico = await res.json();import requests
res = requests.get(
"https://ingestia.io/api/v1/odata",
headers={"Authorization": "Bearer ing_live_EXEMPLO"},
)
servico = res.json()Respuesta 200#
json
{
"@odata.context": "https://ingestia.io/api/v1/odata/$metadata",
"value": [
{ "name": "vendas", "kind": "EntitySet", "url": "vendas" }
]
}Para los tipos de las columnas (EDMX), consulta
GET /api/v1/odata/$metadata.
Notas#
- Las entidades del service document son idénticas a las de
$metadata— misma allowlist de gobernanza (PII fuera, siempre). - Sin datalake aprovisionado, el feed responde
503en producción (nunca finge).
Errores#
| Código | Cuándo |
|---|---|
401 | clave ausente/inválida |
403 | rol/alcance insuficiente |
429 · 402 | rate limit (120/min por clave) / pago pendiente |
503 | datalake no aprovisionado / nube propia caída / limitador no disponible |
Seguridad#
- Solo lectura, con alcance al workspace (solo marts publicados).
- Las columnas PII no aparecen en el service document ni en
$metadata.
Relacionados#
Última revisión: 2026-09-08.