access
POST /v1/orgs/{orgId}/delegated-access/revoke
Revoke one person from every site, or from chosen sites.
Аутентификација
Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.
Где се уноси ID ваше организације
Ова крајња тачка узима ID ваше организације у самом URL-у, као orgId. Замените га у путањи — не постоји заглавље или параметар упита који могу послужити уместо тога.
Идентификатор ваше организације се налази на екрану са API кључевима на вашој контролној табли, поред самог кључа. То је исти идентификатор у сваком позиву који упутите.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/orgs/{orgId}/delegated-access/revoke \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "email": <string> }'Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Revokes the person's grants in this organisation — all of them when site_ids is omitted, or only those sites. Rows are kept and marked revoked. A pending person's invitation is withdrawn with their last pending grant. When nothing is left their site_collaborator membership is removed (membership_removed). Takes effect on the person's next request, in the app, the API and the CLI alike, whatever token they hold: a collaborator's reach is resolved from their live grants on every request. Idempotent — revoking somebody who holds nothing answers 200 with revoked: 0.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
orgId (path) | Uuid | Да | Organization ID (UUIDv7). |
Тело захтева
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
email | string | Да | — |
site_ids | string[] | Не | Omitted revokes every site; given, only these. |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
revoked | integer | Да | — |
membership_removed | boolean | Да | — |
wp_admin_sites | integer | Да | Sites where this person had opened WordPress admin from the dashboard recently enough for a live session to still exist, and where one is therefore being ended. Ending it happens… |
wp_admin_sites_stale_plugin | integer | Да | How many of wp_admin_sites are running a Zinn® plugin older than the release that can end a live session. On those the person keeps WordPress admin until WordPress ends the… |
Грешке које ова крајња тачка може вратити
401 · 403 · 404 · 422 · 429