Jepni dhe revokoni një domen
Një domen i tërë njëherësh: çdo adresë në të, përfshirë ato që shtohen më vonë.
Ekzekuton cilëndo nga 2 thirrjet në hapësirën tuaj të punës.
POST /members/{userId}/domains
Një domen i tërë njëherësh: çdo adresë në të, përfshirë ato që shtohen më vonë.
Jepni një domen
Kërkon members:write. POST /members/{userId}/domains me { domainId, access }; access si parazgjedhje është member. Kthen të gjithë anëtarin ashtu siç është tani, me të drejtën te domains.
curl -X POST "$OE/members/nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t/domains" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "domainId": "7d2a9c41-5b3e-4f8a-9c06-1e2b3c4d5e6f", "access": "viewer" }'{ "object": "member", "userId": "nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t", "email": "[email protected]", "role": { "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "builtin": null }, "addresses": [], "domains": [ { "domainId": "7d2a9c41-5b3e-4f8a-9c06-1e2b3c4d5e6f", "domain": "acme.com", "access": "viewer" } ] }Një upsert, si dhënia e një adrese: ripostimi me një access tjetër e ndryshon të drejtën në vend që të shtojë një të dytë.
Një e drejtë mbi një domen arrin çdo adresë të domenit, përfshirë adresat e shtuara pasi u dha, ndaj është e drejta për dikë që kujdeset për një domen të tërë. Adresat e dhëna një nga një mbeten siç janë krahas saj.
Personi duhet të jetë tashmë në hapësirën e punës, ndaj ftojeni fillimisht me POST /members. Pronari refuzohet me member_is_owner, sepse ai arrin çdo domen, dhe një hapësirë pune plani i së cilës nuk përfshin anëtarë ekipi refuzohet me 403 plan_required.
Një çelës ose një aplikacion i kufizuar në adresa ose domene të caktuara refuzohet me 422 capability_unsupported, dhe një aplikacion që vepron për një anëtar mund të japë vetëm një domen që ai anëtar e arrin.
Një token qasjeje OAuth ka nevojë për një kod verifikimi për këtë thirrje. Derisa aplikacioni të ketë verifikuar një në 60 minutat e fundit, thirrja përgjigjet me 403 step_up_required dhe nuk ndryshon asgjë. Një çelësi API nuk i kërkohet kurrë. Faqja Autentikimi tregon si të kërkoni një kod dhe ta verifikoni.
Revokoni një domen
Kërkon members:write. DELETE /members/{userId}/domains/{domainId}. Kthen anëtarin, pa atë domen.
curl -X DELETE \ "$OE/members/nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t/domains/7d2a9c41-5b3e-4f8a-9c06-1e2b3c4d5e6f" \ -H "$AUTH"{ "object": "member", "userId": "nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t", "email": "[email protected]", "role": { "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "builtin": null }, "addresses": [], "domains": [] }Adresat e domenit që u dhanë një nga një mbeten të dhëna, dhe personi e ruan rolin e tij.
Një domen që nuk i përket kësaj hapësire pune refuzohet me 422 member_not_found në vend që të shpërfillet në heshtje.
Një token qasjeje OAuth ka nevojë për një kod verifikimi për këtë thirrje. Derisa aplikacioni të ketë verifikuar një në 60 minutat e fundit, thirrja përgjigjet me 403 step_up_required dhe nuk ndryshon asgjë. Një çelësi API nuk i kërkohet kurrë. Faqja Autentikimi tregon si të kërkoni një kod dhe ta verifikoni.