Pular para o conteúdo
Atualizado em 2026-10-04

Notas de versão e mudanças

Como o ingestia.io versiona releases, comunica mudanças que quebram compatibilidade, migra formatos versionados e descontinua recursos — e o estado atual desta prática.

Nesta página (10)

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 Descontinuado na 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 queAntesAgoraPor quê
Amazon S3 e Google Cloud Storage como fonteRoadmapAcesso limitadopassaram 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 HubSpotcadastro recusadoAcesso limitadoa renovação automática do acesso passou a ser guardada pela plataforma; a recusa deixou de existir
Azure Blob Storagecadastro recusadoAcesso limitadoa leitura do container entrou no mesmo fluxo de fontes dos demais
Catálogo de conectores21110, em 14 categoriasERPs, 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"#

  1. Confira em Novidades o que mudou no produto.
  2. Consulte Status e limitações para o quadro geral.
  3. 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.

Links relacionados