Dos funciones en la misma ruta:
entity = "$metadata"→ documento EDMX (XML) con los tipos EDM de las columnas.entity = "<tabela>"(nombre de una tabla) → página del EntitySet con paginación server-driven.
Resumen#
| Método · ruta | GET /api/v1/odata/{entity} |
| Base | https://ingestia.io |
| Auth | Clave de API (Authorization: Bearer o ?api_key=) |
| Rol (RBAC) | exportación de datos (member+); clave de datos = owner |
| Costo | bytes reales procesados en el datalake; $count=true ejecuta un COUNT(*) adicional |
| Estados | 200 · 400 · 401 · 403 · 404 · 429 · 402 · 501 · 503 |
Opciones OData compatibles (pushdown honesto)#
| Opción | Se convierte en | Observación |
|---|---|---|
$select | proyección de columnas | reduce los bytes leídos |
$filter | eq/ne/gt/ge/lt/le, and/or/not, contains/startswith/endswith | fuera del subconjunto → 501 |
$orderby | ORDER BY | orden total (paginación estable) |
$top / $skip | límite/desplazamiento | página de hasta 1.000 filas |
$count=true | @odata.count | COUNT(*) incluido en el costo |
Prefer: odata.maxpagesize=N | reduce la página | responde Preference-Applied |
Nunca ignoramos un filtro
Una opción fuera del subconjunto ($expand, $apply, $search, $compute, lambdas
any/all, aritmética en filtros) responde con un 501 explícito indicando lo que es
compatible — un resultado equivocado en silencio sería peor.
Ejemplo — $metadata#
curl -H "Authorization: Bearer ing_live_EXEMPLO" \
https://ingestia.io/api/v1/odata/\$metadataconst res = await fetch("https://ingestia.io/api/v1/odata/$metadata", {
headers: { Authorization: "Bearer ing_live_EXEMPLO" },
});
const edmxXml = await res.text();import requests
res = requests.get(
"https://ingestia.io/api/v1/odata/$metadata",
headers={"Authorization": "Bearer ing_live_EXEMPLO"},
)
edmx_xml = res.textEjemplo — página de una entidad#
curl -H "Authorization: Bearer ing_live_EXEMPLO" \
"https://ingestia.io/api/v1/odata/vendas?\$select=data,total&\$filter=data ge 2026-01-01&\$orderby=data&\$count=true"const params = new URLSearchParams({
"$select": "data,total",
"$filter": "data ge 2026-01-01",
"$orderby": "data",
"$count": "true",
});
const res = await fetch(`https://ingestia.io/api/v1/odata/vendas?${params}`, {
headers: { Authorization: "Bearer ing_live_EXEMPLO" },
});
const pagina = await res.json();import requests
res = requests.get(
"https://ingestia.io/api/v1/odata/vendas",
params={
"$select": "data,total",
"$filter": "data ge 2026-01-01",
"$orderby": "data",
"$count": "true",
},
headers={"Authorization": "Bearer ing_live_EXEMPLO"},
)
pagina = res.json()Respuesta 200 (página)#
json
{
"@odata.context": "https://ingestia.io/api/v1/odata/$metadata#vendas",
"@odata.count": 12345,
"value": [ { "data": "2026-01-02", "total": 987.65 } ],
"@odata.nextLink": "https://ingestia.io/api/v1/odata/vendas?...$skiptoken=..."
}Sigue el
@odata.nextLink exactamente
El enlace lleva un $skiptoken opaco. Un token adulterado responde 400.
Power BI/Excel siguen el nextLink automáticamente hasta el final.
Errores#
| Código | Cuándo |
|---|---|
400 | $skiptoken inválido / paginación por encima de 1.000.000 de filas |
401 | clave ausente/inválida |
403 | rol/alcance insuficiente |
404 | EntitySet inexistente (también evita la enumeración) |
501 | opción OData fuera del subconjunto |
429 · 402 | rate limit / pago pendiente |
503 | datalake no aprovisionado / nube propia caída |
Costo#
- Cobra por los bytes reales;
$select/$filterreducen lo que se lee (pushdown). - Cada llamada deja el costo atribuido en la auditoría
(
api.odata.read, con bytes, página y clave).
Seguridad#
- Solo lectura, alcance por workspace; las columnas PII y
STRUCT/RECORDquedan fuera del feed. Nube propia caída →503(nunca una colección vacía, que Excel leería como "la tabla se vació").
Relacionados#
Última revisión: 2026-09-08.