access

POST `/v1/access/impersonation/redeem`

Exchange a single-use impersonation ticket for a session token.

Autenticación

Este endpoint es público. No requiere credenciales ni organización; es lo que leen nuestro propio sitio de marketing y los motores de respuesta de IA.

Este endpoint no requiere ningún id de organización. Su clave ya identifica la organización a la que pertenece, y la respuesta está delimitada a ella.

Pruébalo

Reemplaza cualquier elemento entre corchetes angulares por tus propios valores, y el marcador de posición key con una clave de tu panel de control.

curl -X POST https://api.zinndigital.com/v1/access/impersonation/redeem \
  -H "Content-Type: application/json" \
  -d '{ "ticket": <string> }'

¿Has iniciado sesión? La consola de la API en tu panel de control rellena el ID de tu organización real y tu propia clave, y ejecuta la solicitud contra la API en vivo para que puedas ver la respuesta real. Abre este endpoint en la consola de la API

Detalles

Called by the customer dashboard when a staff member follows an `ImpersonationGrant.url`. **Unauthenticated by design** — the caller is the app at the instant it has no session, which is the whole point. Authorisation is the ticket: single-use, five minutes, 32 bytes of entropy, stored only as a SHA-256 digest, and bound to a grant a staff member is on the audit log for opening. Every refusal returns the same 401 message. Distinguishing "no such ticket" from "already redeemed" from "expired" would tell a caller which of their guesses was once real.

Cuerpo de la solicitud

Nombre	Tipo	Obligatorio	¿Qué es esto?
`ticket`	`string`	Sí	—

Respuesta

Nombre	Tipo	Obligatorio	¿Qué es esto?
`token`	`string`	Sí	The customer session bearer token (carries the staff `act` claim).
`expires_at`	`string`	Sí	—
`session_id`	`string`	Sí	—
`org_id`	`string`	Sí	The single org this grant is good for.
`org_name`	`string`	Sí	—
`actor`	`string`	Sí	The real staff actor (`user:<id>`), for the banner.

Errores que este endpoint puede devolver

401 · 422 · 429 · 503

POST /v1/access/impersonation/redeem