Como o ingestia.io identifica versões, comunica mudanças e preserva a compatibilidade — para você planejar integrações com segurança.
O que mudou para quem usa
As mudanças de tela e de comportamento, em português de quem usa, ficam em Novidades.
Formato da versão#
Cada build carrega uma versão determinística por commit, no formato
v1.<dia-do-ano>.<commits-no-dia>, com o hash do commit e o horário de build.
Exemplo (sintético): v1.251.2 · commit 4a4ec2f · 2026-09-08T11:29:31Z.
- A versão é auto-gerada no build (não é editada à mão).
- Serve para rastrear qual build está no ar e correlacionar com o suporte.
- Não é um número de release comercial: identifica o build, não um pacote vendido.
Fonte da verdade de estado#
O estado de cada recurso (disponível, acesso limitado, planejado) muda junto com o código: mudança de estado = mudança de doc no mesmo release — a doc nunca "adianta" um estado que o código não sustenta.
Acompanhe o estado consolidado em Status e disponibilidade.
Compatibilidade e formatos versionados (N−1)#
Formatos que viajam entre versões — widgets, filtros, tema, estado de URL e token de embed — usam envelopes com versão e um decoder N−1 obrigatório:
- Um leitor mais novo sempre consegue ler o formato da versão anterior.
- Um campo desconhecido nunca é descartado silenciosamente na leitura.
- Ao subir uma versão de formato, o decoder anterior é mantido.
Isso significa que links compartilhados, dashboards salvos e tokens de embed continuam válidos através de atualizações.
Mudanças que quebram compatibilidade (breaking changes)#
Quando uma mudança puder afetar integrações, a política é:
- Preferir aditivo: novos campos/opções em vez de remover/renomear.
- Sinalizar o estado: a página do recurso muda junto (ex.: passa a dizer "planejado" se algo for adiado).
- Comunicar antes: mudanças que afetam integrações (API/OData, embed, SSO/SCIM) são avisadas em Novidades e pelo suporte.
- Schema de banco é aditivo: mudanças de schema são aditivas e versionadas (migrations), sem quebrar leituras existentes.
Migrações#
- Formatos de conteúdo (widget/filtro/tema/URL/embed): migração automática na leitura via decoder N−1 — você não precisa reescrever nada.
- Schema de metadados (banco de controle): migrations versionadas aplicadas pela plataforma; nada de ação manual do cliente.
- Dado de negócio (datalake): governado pelo cliente (controlador) — ver Governança e LGPD.
Descontinuação (deprecação)#
- Recursos descontinuados recebem o badge
Descontinuadona doc; evite depender deles. - Recursos ainda não construídos ficam como
Roadmap(ex.: CDC verdadeiro, webhooks públicos, API de escrita, chave de API por membro) — ver Status e limitações.
Mudanças de estado já publicadas#
Mudança de estado é mudança de documentação no mesmo release. O que mudou até aqui:
| O que | Antes | Agora | Por quê |
|---|---|---|---|
| Amazon S3 e Google Cloud Storage como fonte | Roadmap | Acesso limitado | passaram a ter leitura real (listagem e download do bucket do cliente); a liberação geral depende de validação com um bucket real |
| Bling, Conta Azul e HubSpot | cadastro recusado | Acesso limitado | a renovação automática do acesso passou a ser guardada pela plataforma; a recusa deixou de existir |
| Azure Blob Storage | cadastro recusado | Acesso limitado | a leitura do container entrou no mesmo fluxo de fontes dos demais |
| Catálogo de conectores | 21 | 110, em 14 categorias | ERPs, lojas, meios de pagamento, CRMs, marketing, produtividade, dados públicos, warehouses, pastas remotas, APIs genéricas e bancos compatíveis |
Todo conector novo entrou em Acesso limitado, nunca como disponível: a
especificação de cada um foi escrita a partir da documentação pública da API, sem
credencial real. A promoção a disponível é decisão humana, um conector por vez, depois de
validação com conta real e 30 dias de execução acompanhada. A lista completa, com o
estado de cada um, está em Conectores.
TOTVS Protheus, Senior e PagBank entraram como Planejado: a API deles não é
pública/estável ou não lista registros, então não há conector — e dizer isso vale mais que
oferecer um que falharia na primeira chamada.
Como saber "o que mudou para mim"#
- Confira em Novidades o que mudou no produto.
- Consulte Status e limitações para o quadro geral.
- Para integrações, monitore o comportamento das rotas
/api/v1(o formato de erro e os limites estão em Erros e limites).
Limites desta página#
- O histórico publicado é o de Novidades: mudanças que o cliente percebe, não cada build.
Relacionados#
Última revisão: 2026-09-08. Versão determinística por commit; compatibilidade N−1 dos formatos versionados.