access

POST `/v1/access/impersonation/redeem`

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

Санҷиши ҳаққоният

Ин нуқтаи поёни оммавӣ аст. Он ҳеҷ гуна маълумоти эътимоднок ва ҳеҷ гуна созмонро талаб намекунад — он ҳамон чизест, ки сайти маркетингӣ ва муҳаррикони ҷавоби сунъии худи мо мехонанд.

Ин нуқтаи поёнӣ ягон рақами мушаххаси созмонро талаб намекунад. Калиди шумо аллакай созмонеро, ки ба он тааллуқ дорад, муайян мекунад ва ҷавоб ба он маҳдуд карда мешавад.

Санҷидан

Ҳар чизро дар қаavски кунҷӣ бо қиматҳои худ ва ҷойи нигоҳдорандаи калидро бо калима аз панели идоракунии худ иваз кунед.

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

Воarid шудаед? Консоли API дар панели идоракунии шумо рақами мушаххаси ташкилоти воқеӣ ва калиди худро пур мекунад ва дархостро бар зидди API-и фаъол иҷро мекунад, то шумо посухи воқеиро бубинед. Ин нуқтаи ниҳоиро дар консоли API кушоед

Тафсилот

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.

Ҷисми дархост

Ном	Намуд	Талаб карда мешавад	Ин чӣ аст
`ticket`	`string`	Бале	—

Ҷавоб

Ном	Намуд	Талаб карда мешавад	Ин чӣ аст
`token`	`string`	Бале	The customer session bearer token (carries the staff `act` claim).
`expires_at`	`string`	Бале	—
`session_id`	`string`	Бале	—
`org_id`	`string`	Бале	The single org this grant is good for.
`org_name`	`string`	Бале	—
`actor`	`string`	Бале	The real staff actor (`user:<id>`), for the banner.

Хатоҳое, ки ин нуқтаи ниҳоӣ метавонад баргардонад

401 · 422 · 429 · 503

POST /v1/access/impersonation/redeem