access

POST `/v1/access/impersonation/redeem`

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

Kimlik Doğrulama

Bu uç nokta arakatmana açıktır. Kimlik bilgisi ve organizasyon gerektirmez; kendi pazarlama sitemizin ve yapay zeka yanıt motorlarımızın okuduğu yerdir.

Bu uç nokta hiçbir organizasyon kimliği almaz. Anahtarınız zaten ait olduğu organizasyonu tanımlar ve yanıt bu organizasyonla sınırlandırılır.

Dene

Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.

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

Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın

Ayrıntılar

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.

İstek gövdesi

Ad	Tür	Zorunlu	Ne olduğu
`ticket`	`string`	Evet	—

Yanıt

Ad	Tür	Zorunlu	Ne olduğu
`token`	`string`	Evet	The customer session bearer token (carries the staff `act` claim).
`expires_at`	`string`	Evet	—
`session_id`	`string`	Evet	—
`org_id`	`string`	Evet	The single org this grant is good for.
`org_name`	`string`	Evet	—
`actor`	`string`	Evet	The real staff actor (`user:<id>`), for the banner.

Bu uç noktanın dönderebileceği hatalar

401 · 422 · 429 · 503

POST /v1/access/impersonation/redeem