Pasar de v1 a v1.1

La solicitud v1.1 es la solicitud v1 con un tag en lugar del recorrido fijo. La ruta, la firma HMAC, los encabezados, el límite de 16384 bytes, las referencias, el token del navegador y las reglas de reintento no cambian. Esta página enumera lo que sí cambia.

Construya y pruebe el nuevo cuerpo con los archivos publicados del contrato v1.1: el contrato OpenAPI v1.1, sus esquemas de solicitud y de respuesta y los ejemplos sintéticos.

El cuerpo

v1	v1.1
`"schema_version": "event-assessment-request.v1"`	`"schema_version": "event-assessment-request.v1.1"`
`journey`, `action` y `journey_context`	Eliminados. Enviar cualquiera de ellos es `400 validation-failed`
—	`tag`, obligatorio: su nombre para el momento, como máximo diez dígitos en total (recorridos y etiquetas)
`deadline_ms`: el rango del recorrido	`deadline_ms`: 250–5000, `null` = 5000, para todas las etiquetas
Todo lo demás	Sin cambios: `external_event_id`, `idempotency_key`, `occurred_at`, `subject_ref`, `account_ref`, `event_context_token`

La respuesta

La respuesta de una solicitud v1.1 es event-assessment.v1.1. Es la respuesta v1 con tag en lugar de journey: el estado, la puntuación, la recomendación, los indicadores, las versiones y el límite de tamaño son los mismos. Compruebe que external_event_id y tag sean los que usted envió, como antes comprobaba journey. Una solicitud v1 sigue recibiendo event-assessment.v1.

Pasos

Elija una etiqueta por punto de llamada. Para una integración solo de inicio de sesión, basta con login. Consulte las plantillas de recorrido para otros momentos.
Construya el cuerpo v1.1: cambie schema_version, quite journey, action y journey_context, y agregue tag. Siga serializando una sola vez y firmando exactamente los bytes que envía.
Use valores nuevos de external_event_id y idempotency_key para las operaciones v1.1. Un ID ya usado por una operación v1 y enviado de nuevo como v1.1 es 409 idempotency-conflict: es otra operación, incluso para el mismo evento.
Durante un reintento, nunca cambie de perfil. Una operación v1 se reintenta como v1, con los mismos bytes.
Lea la respuesta según su schema_version: event-assessment.v1 tiene journey; event-assessment.v1.1 tiene tag.
En la consola, los accesos de una llamada v1.1 muestran la etiqueta; los accesos v1 anteriores conservan el nombre de su recorrido.

Lo que no cambia: la puntuación, la política y la recomendación para la misma evidencia; su credencial y sus permisos; el Web SDK; las rutas de feedback, que siguen apuntando al assessment_id.

Una llamada v1 LOGIN, como cuerpo 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
}