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/tables

Referencia del endpoint que lista las tablas de los marts publicados (gold+silver) del workspace — método, auth, respuestas y ejemplos.

En esta página (8)

La API de consulta REST (/api/v1) está en acceso anticipado y todavía no está abierta para uso externo. El código existe y el contrato de abajo es el del comportamiento actual. Para consumo externo ahora, use el feed OData.

Acceso anticipado

Este contrato está documentado para planificación y transparencia. No construyas integraciones críticas sobre la API REST mientras no se libere. Para leer tablas hoy, prefiere OData.

Lista las tablas de los marts publicados (datasets *_gold y *_silver) del workspace resuelto por la clave de API. Solo lectura, con alcance al workspace.

Resumen#

Método · rutaGET /api/v1/tables
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 (listar el catálogo no genera un job pagado)
Estados200 · 401 · 403 · 429 · 402 · 503

Parámetros#

Ningún parámetro de query. También responde a OPTIONS (preflight CORS) con 204.

Encabezados de respuesta#

  • X-Ingestia-Access-Scope: workspace (la clave lee el workspace entero).
  • Content-Type: application/json; charset=utf-8.

Ejemplo#

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

Respuesta 200#

json
[
  {
    "dataset": "prd_aurora_gold",
    "table": "vendas",
    "layer": "gold",
    "columns": [
      { "name": "data", "type": "DATE" },
      { "name": "total", "type": "NUMERIC" }
    ]
  }
]

Sin datalake aprovisionado (demo), la ruta devuelve un catálogo claramente simulado para validar la integración — nunca finge datos reales.

Errores#

CódigoCuándo
401clave ausente/inválida/revocada
403rol/alcance insuficiente (p. ej.: service principal viewer)
429se superó el rate limit (incluye Retry-After)
402workspace con pago pendiente/suspendido
503limitador no disponible (fail-closed) o datalake no aprovisionado

Formato: { "error": "mensagem em português" } (un mensaje en portugués). Catálogo completo en Errores y límites.

Seguridad#

  • Solo expone marts publicados (gold/silver) — nunca la capa bronze.
  • Las columnas marcadas como PII no aparecen en el catálogo.
  • Alcance por workspace: la clave nunca resuelve a otro cliente.

Relacionados#


Última revisión: 2026-09-08.

Enlaces relacionados