access
GET /v1/access/impersonation/current
The current impersonation status (drives the banner).
Упълномощаване
Изпратете API ключ като носител (bearer token). Тази точка за достъп не указва конкретно разрешение в спецификацията, затова дайте на ключа си най-малкото необходимо и проверете отговора, вместо да правите предположения.
Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.
Опитайте
Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.
curl -X GET https://api.zinndigital.com/v1/access/impersonation/current \
-H "Authorization: Bearer zdk_live_…"Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата
Детайли
Whether the calling session is an impersonation, and if so who (the real staff actor), which org, and when it expires — the source for the non-dismissable "you are viewing as <customer>" banner. Any authenticated caller may ask; a normal session gets active: false.
Отговор
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
active | boolean | Да | — |
actor | string | Не | The real staff actor (user:<id>) when active. |
actor_email | string | Не | The staff actor's e-mail, so the banner names a person rather than an id. Empty when inactive or when the actor is not a user. |
org_id | string | Не | — |
org_name | string | Не | — |
expires_at | string | Не | — |
session_id | string | Не | — |
Грешки, които този крайpoint може да върне
401 · 429