Pular para o conteúdo
FingerTrackIDFingerTrackID Docs
No ar em produção, em modo shadow: o FingerTrackID recomenda, o seu sistema decide.Status →

Migrando do v1 para o v1.1

A requisição v1.1 é a requisição v1 com uma tag no lugar da jornada fixa. A rota, a assinatura HMAC, os cabeçalhos, o limite de 16384 bytes, as referências, o token do navegador e as regras de nova tentativa não mudam. Esta página lista o que muda.

Monte e teste o novo corpo com os arquivos de contrato v1.1 publicados: o contrato OpenAPI v1.1, os schemas de requisição e de resposta desse contrato e os exemplos sintéticos.

O corpo

Seção intitulada “O corpo”
v1 v1.1
"schema_version": "event-assessment-request.v1" "schema_version": "event-assessment-request.v1.1"
journey, action e journey_context Removidos. Enviar qualquer um deles é 400 validation-failed
— tag, obrigatória: o nome que você dá ao momento, com no máximo dez dígitos no total (jornadas e etiquetas)
deadline_ms: a faixa da jornada deadline_ms: 250–5000, null = 5000, para toda etiqueta
Todo o resto Sem mudança: external_event_id, idempotency_key, occurred_at, subject_ref, account_ref, event_context_token

A resposta

Seção intitulada “A resposta”

A resposta de uma requisição v1.1 é event-assessment.v1.1. É a resposta v1 com tag no lugar de journey: o mesmo status, a mesma nota, a mesma recomendação, os mesmos indicadores, as mesmas versões e o mesmo limite de tamanho. Confira se external_event_id e tag são os que você enviou, como você conferia journey antes. Uma requisição v1 continua recebendo event-assessment.v1.

Passos

Seção intitulada “Passos”
  1. Escolha uma etiqueta por ponto de chamada. Para uma integração só de login, login basta. Veja os modelos de jornada para outros momentos.
  2. Monte o corpo v1.1: mude schema_version, retire journey, action e journey_context, adicione tag. Continue serializando uma vez e assinando os bytes exatos que você envia.
  3. Use valores novos de external_event_id e idempotency_key nas operações v1.1. Um ID já usado por uma operação v1, enviado de novo como v1.1, é 409 idempotency-conflict: é outra operação, mesmo para o mesmo evento.
  4. Durante uma nova tentativa, nunca troque de perfil. Uma operação v1 é tentada de novo como v1, com os mesmos bytes.
  5. Leia a resposta pelo schema_version dela: event-assessment.v1 tem journey, event-assessment.v1.1 tem tag.
  6. No console, os acessos de uma chamada v1.1 mostram a etiqueta; os acessos v1 anteriores mantêm o nome da jornada.

O que não muda: a nota, a política e a recomendação para a mesma evidência; a sua credencial e as permissões dela; o Web SDK; as rotas de feedback, que continuam endereçando o assessment_id.

Uma chamada v1 LOGIN, como corpo v1.1:

{
  "schema_version": "event-assessment-request.v1.1",
  "external_event_id": "evt_login_0001",
  "idempotency_key": "idem_evt_login_0001",
  "occurred_at": "2026-11-03T14:05:22.481Z",
  "subject_ref": "usr_5c0e",
  "account_ref": null,
  "event_context_token": "ect_login_0001",
  "tag": "login",
  "deadline_ms": null
}