access

POST `/v1/access/impersonation/redeem`

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

المصادقة

هذه نقطة النهاية عامة. فهي لا تتطلب أي بيانات اعتماد ولا أي مؤسسة - بل هي ما تقرؤه مواقعنا التسويقية ومحركات الإجابة بالذكاء الاصطناعي الخاصة بنا.

لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.

جربه الآن

استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.

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

هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم 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