Pāriet uz dokumentāciju
API

Izgūt dalībnieku

Viens cilvēks, viņa loma un viņa adreses, pēc konta id.

GETapi.openemail.uk/members/{userId}

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

GET /members/{userId}

Viens cilvēks, viņa loma un viņa adreses, pēc konta id.

Piemērs

Nepieciešams members:read. Pēc LIETOTĀJA ID: userId no saraksta, nevis viņa e-pasta adreses.

curl
curl "$OE/members/nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t" -H "$AUTH"
Atbilde
{  "object": "member",  "userId": "nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t",  "email": "[email protected]",  "name": "Sam Okonjo",  "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": "2b81de07-9c1f-4a4b-8e05-d3862c1f0a44",      "address": "[email protected]",      "access": "member"    }  ],  "createdAt": "2026-08-12T14:20:00.000Z"}

Uzmeklēšanas pēc e-pasta adreses šeit nav. POST /members ir vienīgais izsaukums, kas to pieņem, jo tas ir vienīgais izsaukums, kura izsaucējam lietotāja id patiešām vēl nav.

Lietotāja id, kas nepieder šai darbvietai, ir vienkāršs 404. Tas ir vienīgais gadījums šajā resursā, kas nepārprotami nozīmē “tāda resursa nav”. Tas pats apstāklis, ko izraisa rakstīšana, kuru nevarēja nolasīt atpakaļ, kartējas uz 422, kas tur ir pareizi un šeit nepareizi.

Ar nodomu tas tiek nolasīts no pilnā dalībnieku saraksta, nevis ar vienas rindas vaicājumu: dalībnieks ir lomas rindas un adrešu piešķīrumu kopas APVIENOJUMS, un katra no tām var pastāvēt bez otras, un šis apvienojums tiek aprēķināts tieši vienā vietā. Vienas rindas vaicājums būtu tā otra realizācija, un populācija, ko tas klusi izlaistu, ir mantotie piešķīrumu turētāji, kuri šodien veido lielāko daļu tabulas.