Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-09-08

Endpoint: GET /api/v1/odata (service document)

Referencia del service document OData v4 — lista las entidades (tablas gold/silver) que Power BI y Excel descubren para consumir el datalake.

En esta página (8)

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 · rutaGET /api/v1/odata
Basehttps://ingestia.io
AuthClave de API (Authorization: Bearer ing_live_… o ?api_key=)
Rol (RBAC)exportación de datos (member+); clave de datos = owner
CostoR$ 0 (descubrir entidades no genera un job pagado)
EncabezadosOData-Version: 4.0 · X-Ingestia-Access-Scope: workspace
Estados200 · 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/odata

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 503 en producción (nunca finge).

Errores#

CódigoCuándo
401clave ausente/inválida
403rol/alcance insuficiente
429 · 402rate limit (120/min por clave) / pago pendiente
503datalake 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.

Enlaces relacionados