API

Mainīt dalībnieka lomu

Tikai loma un nekas cits. Adreses ir otra ass, un tām ir savi izsaukumi.

PATCHapi.openemail.uk/members/{userId}

Izpilda īstu izsaukumu pret jūsu darbvietu, ar jūsu paša atslēgu.

PATCH /members/{userId}

Tikai loma un nekas cits. Adreses ir otra ass, un tām ir savi izsaukumi.

Piemērs

Nepieciešams members:write. roleId ir vienīgais lauks, un tas ir obligāts. Šis izsaukums nosauc stāvokli, ko tas grib, nevis izmaiņu, ko piemērot, tāpēc, nosūtot to divreiz, tas pats cilvēks turēs to pašu lomu.

curl

curl -X PATCH "$OE/members/7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a" -H "$AUTH" \  -H "Content-Type: application/json" \  -d '{ "roleId": "role_2b81de079c1f0a4b7e05d386" }'

Atbilde

{  "object": "member",  "userId": "7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a",  "email": "[email protected]",  "name": null,  "image": null,  "role": {    "id": "role_2b81de079c1f0a4b7e05d386",    "name": "Support",    "builtin": null  },  "implied": false,  "permissions": [    "emails:send",    "emails:read",    "threads:read",    "threads:write",    "labels:read",    "labels:write",    "contacts:read"  ],  "addresses": [    {      "addressId": "c40a95f2-1cc6-4d31-82a8-9e075d31c2a8",      "address": "[email protected]",      "access": "viewer"    }  ],  "createdAt": "2026-08-30T15:44:02.000Z"}

Adreses no šejienes NAV labojamas, un izlaidums ir apzināts: tās ir kopa ar piekļuves līmeni katram elementam, un PATCH ar masīvu nozīmētu aizstāt visu, kas ir klusa masveida atsaukšana ikreiz, kad klients nosūta novecojušu sarakstu. Abi adrešu izsaukumi pievieno un noņem pa vienam, tāpēc notikušais vienmēr ir tas, kas prasīts.

Tā arī mantotais piešķīrumu turētājs pārstāj būt implied: viņam nav dalībnieka rindas, šis izsaukums to izveido, un no tā brīža viņa atļaujas ir tas, ko kāds izvēlējās, nevis tas, ko nejauši nozīmēja viņa adrešu piekļuve. Ievērojiet, ka atbildē augstāk implied pārslēdzas uz false un parādās createdAt. Viņa adresēs nekas nemainās.

Īpašnieka lomu nevar izdalīt (role_immutable, 409) neatkarīgi no tā, kas ir izsaucējam. Padarīt kādu par īpašnieku nozīmē darbvietas nodošanu, kurai ir citas sekas un kuras šajā API nav.

Viņa jaunā loma stājas spēkā ar viņa nākamo pieprasījumu un ar katras tās ierobežotās API atslēgas nākamo pieprasījumu.