Vault

Un client-token (ctok_) es una credencial efímera y de un solo uso que puedes mandar al navegador para revelar campos concretos de una persona, sin que tu clave secreta salga de tu servidor.

Lo emites con POST /v1/persons/{id}/client-token y lo rediges aquí. Caduca en 15 minutos o al primer uso, lo que ocurra antes.

Solo puede revelar los campos que declaraste al emitirlo. Pedir uno fuera de esa lista es un error, no una revelación parcial.

Redimir un client-token

POST /v1/vault/decrypt

Requiere un client-token (ctok_…).

Canjea un ctok_ por los campos en claro que ese token autoriza. Un solo uso. Si omites fields, devuelve todos los que el token permite; si los pides, tienen que ser un subconjunto.

Cuerpo de la petición

application/json · schema VaultDecryptRequest

CampoRequeridoTipoDescripción
fields no string[] | null

Respuestas

200 Successful Response — DecryptResponse

CampoRequeridoTipoDescripción
fields sí object
object no "person.decrypt"
personId sí string

Errores posibles (problem+json): 400 405 422 500