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/{entity}

Referencia del EntitySet OData (filas paginadas server-driven) y del documento $metadata (EDMX) — con pushdown honesto de $select/$filter/$orderby/$top/$count.

En esta página (9)

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 · rutaGET /api/v1/odata/{entity}
Basehttps://ingestia.io
AuthClave de API (Authorization: Bearer o ?api_key=)
Rol (RBAC)exportación de datos (member+); clave de datos = owner
Costobytes reales procesados en el datalake; $count=true ejecuta un COUNT(*) adicional
Estados200 · 400 · 401 · 403 · 404 · 429 · 402 · 501 · 503

Opciones OData compatibles (pushdown honesto)#

OpciónSe convierte enObservación
$selectproyección de columnasreduce los bytes leídos
$filtereq/ne/gt/ge/lt/le, and/or/not, contains/startswith/endswithfuera del subconjunto → 501
$orderbyORDER BYorden total (paginación estable)
$top / $skiplímite/desplazamientopágina de hasta 1.000 filas
$count=true@odata.countCOUNT(*) incluido en el costo
Prefer: odata.maxpagesize=Nreduce la páginaresponde 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/\$metadata

Ejemplo — 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"

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ódigoCuándo
400$skiptoken inválido / paginación por encima de 1.000.000 de filas
401clave ausente/inválida
403rol/alcance insuficiente
404EntitySet inexistente (también evita la enumeración)
501opción OData fuera del subconjunto
429 · 402rate limit / pago pendiente
503datalake no aprovisionado / nube propia caída

Costo#

  • Cobra por los bytes reales; $select/$filter reducen 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/RECORD quedan 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.

Enlaces relacionados