API

Kişileri listeleme

Uygulamadaki Kişiler sayfasının listelediği herkes: kayıtlı kişiler ve bir ileti dizisinin en yeni iletisinde gönderen ya da alıcı olarak postada görülen her adres, her birinin posta kutusuyla paylaştığı ileti dizisi sayısı ve son postanın ne zaman geldiğiyle. Postada görülen ve kayıtlı olan bir kişi tek satırdır. Sayfalama anahtar tabanlıdır: `limit` en fazla 100'dür ve varsayılanı 25'tir, `hasMore` true olduğu sürece `nextCursor` `cursor` olarak geri gönderilir.

GETapi.openemail.uk/contacts/people

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

GET /contacts/people

Uygulamadaki Kişiler sayfasının listelediği herkes: kayıtlı kişiler ve bir ileti dizisinin en yeni iletisinde gönderen ya da alıcı olarak postada görülen her adres, her birinin posta kutusuyla paylaştığı ileti dizisi sayısı ve son postanın ne zaman geldiğiyle. Postada görülen ve kayıtlı olan bir kişi tek satırdır. Sayfalama anahtar tabanlıdır: limit en fazla 100'dür ve varsayılanı 25'tir, hasMore true olduğu sürece nextCursor cursor olarak geri gönderilir.

Örnek

contacts:read gerektirir. Postada görülen adresler yalnızca anahtar ayrıca threads:read tutuyorsa dahil edilir.

curl

curl "$OE/contacts/people?sort=threads&limit=25" -H "$AUTH"

Yanıt

{  "object": "list",  "data": [    {      "object": "person",      "email": "[email protected]",      "displayEmail": "[email protected]",      "name": "Ada Lovelace",      "saved": true,      "source": "manual",      "notes": "Met at the engine demo",      "photoUrl": null,      "threads": 42,      "lastAt": "2026-09-22T16:04:11.000Z",      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-09-01T09:12:00.000Z",      "blockedBy": null    },    {      "object": "person",      "email": "[email protected]",      "displayEmail": "[email protected]",      "name": "Shop",      "saved": false,      "source": null,      "notes": null,      "photoUrl": null,      "threads": 17,      "lastAt": "2026-09-21T07:30:00.000Z",      "createdAt": null,      "updatedAt": null,      "blockedBy": { "rule": "shop.example", "list": "blockedDomains" }    }  ],  "hasMore": true,  "nextCursor": "WyIyMDI2LTA5LTIxVDA3OjMwOjAwLjAwMFoiLDE3XQ",  "seen": true}

sort; recent (varsayılan), en yeni posta önce ve postada hiç görülmemiş kayıtlı kişiler sonra, name, ada göre ya da ad yoksa adrese göre ve büyük küçük harf ayırmadan, ya da threads, en çok ileti dizisi olan önce. Eşitlikte adres belirler, bu yüzden bir tarama hiçbir satırı tekrarlamaz ya da atlamaz.

q adları, adresleri ve notları arar. email tek bir adresi okur, bir kişinin ileti dizisi sayısını ve son postasını böyle alırsınız. blocked=true yalnızca çalışma alanının engel listesinin engellediği kişileri döndürür, tüm alan adını kapsayan kurallar dahil, blockedBy de her satırda kuralı belirtir.

threads:read olmadan satırlar yalnızca kayıtlı kişilerdir ve seen false olur, çünkü geri kalanı postadan okunur. Silinmiş adresler ve posta kutusunun kendi adresleri hiçbir zaman listelenmez. İmleç opaktır: aynı sort, q ve blocked ile geri gönderin; verilmemiş bir imleç 400 invalid_cursor olur.