Ugrás a dokumentációra
API

Tag lekérése

Egy személy, a szerepköre és a címei, fiókazonosító alapján.

GETapi.openemail.uk/members/{userId}

A valódi hívást futtatja le a munkaterületén, a saját kulcsával.

GET /members/{userId}

Egy személy, a szerepköre és a címei, fiókazonosító alapján.

Példa

members:read szükséges. FELHASZNÁLÓI AZONOSÍTÓ alapján: a listából vett userId, nem az e-mail címük.

curl
curl "$OE/members/nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t" -H "$AUTH"
Válasz
{  "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"}

Itt nincs e-mail cím szerinti keresés. A POST /members az egyetlen hívás, amely e-mail címet fogad, mert ez az egyetlen hívás, amelynek hívója valóban nem rendelkezik még felhasználói azonosítóval.

Egy nem ehhez a munkaterülethez tartozó felhasználói azonosító egyszerű 404. Ez az egyetlen eset ebben az erőforrásban, amely egyértelműen „nincs ilyen erőforrás”. Ugyanez a helyzet egy olyan írásnál, amelynek eredménye nem olvasható vissza, 422-re képeződik, ami ott helyes, itt pedig helytelen.

Szándékosan a teljes taglistából olvassa ki, nem egysoros lekérdezéssel: egy tag egy szerepkörsor és címhozzáférések halmazának UNIÓJA, amelyek bármelyike létezhet a másik nélkül, és ez az unió pontosan egy helyen kerül kiszámításra. Egy egysoros lekérdezés ennek egy második megvalósítása lenne, és a csoport, amelyet csendben kihagyna, a régi hozzáférés-birtokosok, akik ma a tábla nagy részét adják.