Belgelere geç
API

Kitleleri listeleme

Kitle, bu çalışma alanındaki adlandırılmış bir kişi listesidir. Her kişi, var olduğu andan itibaren yerleşik varsayılan kitlededir ve o satırı adlandıran şey `builtin` alanıdır; geri kalanları oluşturmak, doldurmak ve silmek size kalmıştır. Önce varsayılan kitle, ardından diğerleri en yeniden eskiye gelir. Bu sürüm listeleri yönetir ve onlara hiçbir şey göndermez; dolayısıyla arayacağınız bir toplu gönderim uç noktası yoktur.

GETapi.openemail.uk/audiences

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

GET /audiences

Kitle, bu çalışma alanındaki adlandırılmış bir kişi listesidir. Her kişi, var olduğu andan itibaren yerleşik varsayılan kitlededir ve o satırı adlandıran şey builtin alanıdır; geri kalanları oluşturmak, doldurmak ve silmek size kalmıştır. Önce varsayılan kitle, ardından diğerleri en yeniden eskiye gelir. Bu sürüm listeleri yönetir ve onlara hiçbir şey göndermez; dolayısıyla arayacağınız bir toplu gönderim uç noktası yoktur.

Örnek

audiences:read gerektirir. limit en çok 100 olabilir, varsayılanı 25'tir.

curl
curl "$OE/audiences" -H "$AUTH"
Yanıt
{  "object": "list",  "data": [    {      "object": "audience",      "id": "aud_9f2c4b7e1a0d63d84c5f2e7b",      "name": "All contacts",      "description": null,      "builtin": "default",      "contactCount": 412,      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-08-01T10:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

Ada göre değil, builtin alanına göre dallanın. Varsayılan kitlenin adını herkes değiştirebilir ve onunla ilgili değişen tek şey adıdır.

Varsayılan kitle ilk okumada oluşturulur; bu yüzden hiç kitle oluşturmamış bir çalışma alanı bile tam olarak bir satır listeler.

contactCount okuma anında sayılır; bu yüzden bir oluşturma işleminin iki yanında yapılan iki okuma bir fark gösterir. Adlar benzersiz değildir, bu nedenle ad değil id saklayın.