Changelog & Versionamento

Política de versionamento

A API usa URL versioning, com a versão major no path: /v1/..., /v2/....

Tipo de mudança	Quando subimos versão?	Notificação
Adicionar endpoint novo	Não (mesma v1)	Changelog
Adicionar campo opcional em response	Não	Changelog
Adicionar campo opcional em request	Não	Changelog
Tornar campo opcional em response	Não	Changelog
Renomear / remover campo	Sim, nova vMajor	Email 90 dias antes + header Sunset
Mudar tipo de campo	Sim, nova vMajor	Idem
Remover endpoint	Sim, nova vMajor	Idem
Mudar comportamento default	Sim, nova vMajor	Idem

Dica

Compromisso de estabilidade: v1 é mantida por no mínimo 24 meses após anúncio de v2. Migração assistida e período sobreposto.

Deprecation lifecycle

Endpoints ou campos a serem removidos passam por:

1. Anúncio: email + changelog + post no painel
2. Header Deprecation: toda resposta inclui Deprecation: true e Sunset: <data ISO> por 6 meses
3. Período de double-write: quando aplicável, o novo endpoint coexiste com o antigo
4. Remoção: após Sunset, retorna 410 Gone com error.code = "ENDPOINT_REMOVED"

HTTP/1.1 200 OK
Deprecation: true
Sunset: Sat, 18 Nov 2026 00:00:00 GMT
Link: <https://docs-crypto.sentinexrisk.com/api-reference/wallets/screen-v2>; rel="successor-version"

---

Changelog

v1.7.0 (2026-05-18)

Novos

• POST /vasp/customers:batch (bulk até 100)
• POST /vasp/wallets:batch (bulk até 200)
• Webhook event kyc.review_required
• Header X-RateLimit-Scope em todas as respostas
• Suporte a Accept-Language: en-US em mensagens de erro

Melhorias

• Latência KYT p95: 180ms → 95ms
• OpenAPI atualizado (87 paths, 27 tags pt-BR)
• Documentação Scalar/Redoc em /swagger-ui e /docs

v1.6.0 (2026-05-15)

Novos

• Mesa de Escalation: POST /alerts/:id/escalate + GET /escalations
• LGPD DSAR: POST /lgpd/dsar retorna pacote completo do titular em até 15 dias
• Webhooks outbound com HMAC SHA-256 + DLQ

Breaking (apenas se você dependia disso)

• Nenhum. Release puramente aditiva.

v1.5.0 (2026-04-30)

Novos

• Travel Rule IVMS101: POST /compliance/travelrule/originator-info
• COAF SAR draft automático: POST /agent/sar-draft
• DeCripto reporting mensal: POST /compliance/decripto/submit

v1.4.0 (2026-04-15)

Novos

• 24 regras avançadas (R-ADV-01 a R-ADV-24): pig butchering, drainer, SIM swap, deepfake KYC
• Explicabilidade de score: GET /transactions/:id/explain

v1.3.0 (2026-03-30)

Novos

• KYT scoring em tempo real (< 100ms p95)
• Wallet screening on-chain com clustering proprietário
• Rule Engine Grule com hot-reload (86 regras)

v1.2.0 (2026-03-15)

Novos

• SentinexPrint™ 7-layer fingerprint
• KYC PF/PJ com bureau brasileiro (Exato Digital, E-BEF, Quod)

v1.1.0 (2026-02-15)

Novos

• Autenticação JWT RS256 + TOTP MFA
• Multi-tenant com RBAC fino
• Audit trail imutável

v1.0.0 (2026-02-02)

Lançamento inicial

• Endpoints core: /health, /auth/*, /wallets, /transactions, /alerts
• OpenAPI 3.0.3 + Scalar/Redoc
• 5 ambientes (prod, sandbox, dashboard, dev, staging)

---

Assine notificações

• RSS: https://docs.crypto.sentinexrisk.com/changelog/feed.xml
• Email: opt-in no console Settings → Notifications
• Webhook event api.deprecation (em breve)