Cómo ingestia.io identifica versiones, comunica cambios y preserva la compatibilidad — para que puedas planificar integraciones con seguridad.
Qué cambió para quien usa
Los cambios de pantalla y de comportamiento, en portugués de quien usa, están en Novidades.
Formato de la versión#
Cada build carga una versión determinística por commit, en el formato
v1.<día-del-año>.<commits-del-día>, con el hash del commit y la hora del build.
Ejemplo (sintético): v1.251.2 · commit 4a4ec2f · 2026-09-08T11:29:31Z.
- La versión es auto-generada en el build (no se edita a mano).
- Sirve para rastrear qué build está en producción y correlacionar con el soporte.
- No es un número de release comercial: identifica el build, no un paquete a la venta.
Fuente de la verdad del estado#
El estado de cada recurso (disponible, acceso limitado, planificado) cambia junto con el código: cambio de estado = cambio de doc en el mismo release — la doc nunca "adelanta" un estado que el código no sostiene.
Sigue el estado consolidado en Estado y disponibilidad.
Compatibilidad y formatos versionados (N−1)#
Formatos que viajan entre versiones — widgets, filtros, tema, estado de URL y token de embed — usan envoltorios con versión y un decoder N−1 obligatorio:
- Un lector más nuevo siempre puede leer el formato de la versión anterior.
- Un campo desconocido nunca se descarta silenciosamente en la lectura.
- Al subir una versión de formato, el decoder anterior se mantiene.
Esto significa que links compartidos, dashboards guardados y tokens de embed siguen válidos a través de actualizaciones.
Cambios que rompen compatibilidad (breaking changes)#
Cuando un cambio pueda afectar integraciones, la política es:
- Preferir aditivo: nuevos campos/opciones en lugar de eliminar/renombrar.
- Señalar el estado: la página del recurso cambia junto (ej.: pasa a decir "planificado" si algo se aplaza).
- Comunicar antes: los cambios que afectan integraciones (API/OData, embed, SSO/SCIM) se avisan en Novedades y por soporte.
- Esquema de base es aditivo: los cambios de esquema son aditivos y versionados (migrations), sin romper lecturas existentes.
Migraciones#
- Formatos de contenido (widget/filtro/tema/URL/embed): migración automática en la lectura vía decoder N−1 — no necesitas reescribir nada.
- Esquema de metadatos (base de control): migrations versionadas aplicadas por la plataforma; nada de acción manual del cliente.
- Datos de negocio (datalake): gobernado por el cliente (controlador) — ver Governança e LGPD.
Descontinuación (deprecación)#
- Recursos descontinuados reciben el badge
Descontinuadoen la doc; evita depender de ellos. - Recursos aún no construidos quedan como
Roadmap(ej.: CDC verdadero, webhooks públicos, API de escritura, clave de API por miembro) — ver Estado y disponibilidad.
Cambios de estado ya publicados#
Cambio de estado es cambio de documentación en el mismo release. Lo que cambió hasta aquí:
| Qué | Antes | Ahora | Por qué |
|---|---|---|---|
| Amazon S3 y Google Cloud Storage como fuente | Roadmap | Acesso limitado | pasaron a tener lectura real (listado y descarga del bucket del cliente); la liberación general depende de validación con un bucket real |
| Bling, Conta Azul y HubSpot | registro rechazado | Acesso limitado | la renovación automática del acceso pasó a ser gestionada por la plataforma; la denegación dejó de existir |
| Azure Blob Storage | registro rechazado | Acesso limitado | la lectura del container entró en el mismo flujo de fuentes que las demás |
| Catálogo de conectores | 21 | 110, en 14 categorías | ERPs, tiendas, medios de pago, CRMs, marketing, productividad, datos públicos, warehouses, carpetas remotas, APIs genéricas y bases compatibles |
Todo conector nuevo entró en Acesso limitado, nunca como disponible: la
especificación de cada uno fue escrita a partir de la documentación pública de la API, sin
credencial real. La promoción a disponible es decisión humana, un conector a la vez, después de
validación con cuenta real y 30 días de ejecución acompañada. La lista completa, con el
estado de cada uno, está en Conectores.
TOTVS Protheus, Senior y PagBank entraron como Planejado: su API no es
pública/estable o no lista registros, así que no hay conector — y decir eso vale más que
ofrecer uno que fallaría en la primera llamada.
Cómo saber "qué cambió para mí"#
- Revisa en Novidades lo que cambió en el producto.
- Consulta Estado y disponibilidad para el panorama general.
- Para integraciones, monitorea el comportamiento de las rutas
/api/v1(el formato de error y los límites están en Erros e limites).
Límites de esta página#
- El historial publicado es el de Novedades: cambios que el cliente percibe, no cada build.
Relacionados#
Última revisión: 2026-09-08. Versión determinística por commit; compatibilidad N−1 de los formatos versionados.