Belgelere geç
API

Bir kitlenin kişilerini listeleme

Üyelik kayıtları yerine kişilerin kendisi, kişiler listesiyle aynı sırada: en son görülen başta, hiç posta gönderilmemiş kişiler sonda. `limit` en çok 200 olabilir, varsayılanı 50'dir. Varsayılan kitleyi buradan okumak adres defterinin tamamını döndürür.

GETapi.openemail.uk/audiences/{id}/contacts

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

GET /audiences/{id}/contacts

Üyelik kayıtları yerine kişilerin kendisi, kişiler listesiyle aynı sırada: en son görülen başta, hiç posta gönderilmemiş kişiler sonda. limit en çok 200 olabilir, varsayılanı 50'dir. Varsayılan kitleyi buradan okumak adres defterinin tamamını döndürür.

Örnek

contacts:read olmadan, tek başına audiences:read gerektirir.

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"
Yanıt
{  "object": "list",  "data": [    {      "object": "contact",      "email": "[email protected]",      "name": "Grace Hopper",      "source": "manual",      "notes": null,      "lastSeenAt": null,      "createdAt": "2026-09-18T09:00:00.000Z",      "updatedAt": "2026-09-18T09:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null,  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71"}

audiences:read taşıyan bir anahtar, contacts:read taşımadan bir kitledeki adresleri okur. Böyle bir anahtarı bilerek verin.

Kendi kitlelerinizin hiçbirinde olmayan bir kişi yine de varsayılan kitlededir; dolayısıyla defterdeki hiçbir şey bu uç nokta için görünmez değildir.