Belgelere geç
API

Kişileri listeleme

Çalışma alanının adres defteri; en son görülen başta, hiç posta gönderilmemiş kişiler sonda. Çalışma alanındaki her anahtar aynı satırları okur; bir üyenin kaydettiği kişi, her üyenin ve her anahtarın gördüğü bir kişidir. Sayfalama keyset tabanlıdır: `limit` en çok 200 olabilir, varsayılanı 50'dir ve `hasMore` true olduğu sürece `nextCursor` değeri `cursor` olarak geri gönderilir.

GETapi.openemail.uk/contacts

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

GET /contacts

Çalışma alanının adres defteri; en son görülen başta, hiç posta gönderilmemiş kişiler sonda. Çalışma alanındaki her anahtar aynı satırları okur; bir üyenin kaydettiği kişi, her üyenin ve her anahtarın gördüğü bir kişidir. Sayfalama keyset tabanlıdır: limit en çok 200 olabilir, varsayılanı 50'dir ve hasMore true olduğu sürece nextCursor değeri cursor olarak geri gönderilir.

Örnek

contacts:read gerektirir.

curl
curl "$OE/contacts?limit=50" -H "$AUTH"
Yanıt
{  "object": "list",  "data": [    {      "object": "contact",      "email": "[email protected]",      "name": "Ada Lovelace",      "source": "auto",      "notes": null,      "lastSeenAt": "2026-08-29T08:19:08.000Z",      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-08-29T08:19:08.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

source, adresi biri kaydettiğinde (uygulamada ya da POST /contacts ile) manual, bir üye yazma penceresinden adrese posta gönderdiği için kaydedildiğinde auto olur. Bunlar özü bakımından farklı iddialardır (auto yazışmanın kanıtı, manual niyetin kanıtıdır) ve dallanmaya değer.

Sıralama, null değerler sonda olacak şekilde lastSeenAt azalan, ardından en yeniden eskiye doğrudur. Yeni oluşturduğunuz bir kişinin lastSeenAt değeri yoktur ve başta değil sonda sıralanır.

Defter, satırı kaydeden kişiye değil çalışma alanına aittir. Bir adresten gelen posta hiçbir kayıt oluşturmaz.