API

Izgūt lomu

Viena loma pilnībā, ar visu tās atļauju sarakstu un to, kas to pašlaik tur.

GETapi.openemail.uk/roles/{id}

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

GET /roles/{id}

Viena loma pilnībā, ar visu tās atļauju sarakstu un to, kas to pašlaik tur.

Piemērs

Nepieciešams roles:read. Id nes role_ prefiksu.

curl

curl "$OE/roles/role_2b81de079c1f0a4b7e05d386" -H "$AUTH"

Atbilde

{  "object": "role",  "id": "role_2b81de079c1f0a4b7e05d386",  "name": "Support",  "description": "Answers the shared inboxes and nothing else.",  "permissions": [    "emails:send",    "emails:read",    "threads:read",    "threads:write",    "labels:read",    "labels:write",    "contacts:read"  ],  "builtin": null,  "editable": true,  "deletable": true,  "members": 3,  "apiKeys": 1,  "createdAt": "2026-08-30T10:41:02.000Z",  "updatedAt": "2026-08-30T12:15:44.000Z"}

Loma citā darbvietā ir 404, nevis 403 — tā pati atbilde kā id, kas nekad nav pastāvējis, jo pateikt atslēgai, kuri id pastāv darbvietā, kuru tā nevar lasīt, pati par sevi ir noplūde.

permissions ir viss piešķīrums, plakans un jau izvērsts. Nekā cita, ko ielādēt, nav, un atsevišķa galapunkta katrai atļaujai nav: loma tiek lasīta kā viens saraksts, jo auditē tieši sarakstu.

Tas nepasaka, KAS to tur. members un apiKeys ir skaitļi; vārdi aiz pirmā ir GET /members, un galapunkta, kas uzskaitītu lomas atslēgas, nav.