Belgelere geç
API

Bir üyeyi getir

Bir kişi, rolü ve adresleri; hesap id'sine göre.

GETapi.openemail.uk/members/{userId}

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

GET /members/{userId}

Bir kişi, rolü ve adresleri; hesap id'sine göre.

Örnek

members:read gerektirir. KULLANICI ID'siyle: listedeki userId, e-posta adresi değil.

curl
curl "$OE/members/nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t" -H "$AUTH"
Yanıt
{  "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"}

Burada e-postaya göre arama yoktur. POST /members e-posta alan tek çağrıdır, çünkü çağıranın gerçekten henüz bir kullanıcı id'sine sahip olmadığı tek çağrı odur.

Bu çalışma alanında olmayan bir kullanıcı id'si düz bir 404'tür. Bu kaynakta açıkça "böyle bir kaynak yok" olan tek durumdur. Aynı koşul, geri okunamayan bir yazma işleminden doğduğunda 422'ye eşlenir; bu orada doğru, burada yanlıştır.

Tek satırlık bir sorgu yerine bilerek tam üye listesinden okunur: bir üye, bir rol satırı ile bir adres yetkileri kümesinin BİRLEŞİMİDİR; her biri diğeri olmadan var olabilir ve bu birleşim tam olarak tek bir yerde hesaplanır. Tek satırlık bir sorgu bunun ikinci bir uygulaması olurdu ve sessizce atlayacağı kitle, bugün tablonun çoğunu oluşturan eski yetki sahipleri olurdu.