Przejdź do dokumentacji
API

Pobierz członka

Jedna osoba, jej rola i jej adresy, po identyfikatorze konta.

GETapi.openemail.uk/members/{userId}

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

GET /members/{userId}

Jedna osoba, jej rola i jej adresy, po identyfikatorze konta.

Przykład

Wymaga members:read. Po IDENTYFIKATORZE UŻYTKOWNIKA: userId z listy, a nie po adresie e-mail.

curl
curl "$OE/members/nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t" -H "$AUTH"
Odpowiedź
{  "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"}

Nie ma tu wyszukiwania po adresie e-mail. POST /members to jedyne wywołanie, które go przyjmuje, ponieważ jest to jedyne wywołanie, w którym wywołujący faktycznie nie ma jeszcze identyfikatora użytkownika.

Identyfikator użytkownika, którego nie ma w tej przestrzeni roboczej, to zwykłe 404. To jedyny przypadek w tym zasobie, który jednoznacznie oznacza „nie ma takiego zasobu”. Ten sam warunek zgłoszony przez zapis, którego nie dało się odczytać z powrotem, mapuje się na 422, co tam jest słuszne, a tutaj byłoby błędem.

Odczytywane z pełnej listy członków, a nie zapytaniem o pojedynczy wiersz, i to celowo: członek jest SUMĄ wiersza roli i zbioru uprawnień do adresów, z których każde może istnieć bez drugiego, a ta suma jest wyliczana dokładnie w jednym miejscu. Zapytanie o pojedynczy wiersz byłoby jej drugą implementacją, a populacją, którą po cichu by pominęło, są posiadacze starszych uprawnień, którzy stanowią dziś większość tabeli.