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

Selo de estado: Preview — feed OData v4, sem SLA. Superfície disponível em Preview para consumo externo (Power BI/Excel). Atualizado em 2026-09-08. Fonte de estado: matriz de estados do produto.

O service document é a porta de entrada do feed OData v4: lista uma entidade por tabela publicada (*_gold/*_silver) do workspace. Power BI e Excel descobrem os feeds a partir daqui.

Resumo#

Parâmetros#

Nenhum. Responde também OPTIONS (pré-flight CORS).

Exemplo#

curl -H "Authorization: Bearer ing_live_EXEMPLO" \
  https://ingestia.io/api/v1/odata

const 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

Resposta 200#

{
  "@odata.context": "https://ingestia.io/api/v1/odata/$metadata",
  "value": [
    { "name": "vendas", "kind": "EntitySet", "url": "vendas" }
  ]
}

Para os tipos das colunas (EDMX), veja GET /api/v1/odata/$metadata.

Notas#

• As entidades do service document são idênticas às do $metadata — mesma allowlist de governança (PII fora, sempre).
• Sem datalake provisionado, o feed responde 503 em produção (nunca finge).

Erros#

Segurança#

• Somente leitura, escopado ao workspace (marts publicados apenas).
• Colunas PII não aparecem no service document nem no $metadata.

Relacionados#

• Endpoint: OData de uma entidade / $metadata
• OData · Power BI · Excel (kit e guia)
• Autenticação

Última revisão: 2026-09-08. Estado & evidência: OData v4 = Preview. Fonte: matriz de estados do produto.