Ugrás a dokumentációra
API

Közönségek listázása

A közönség a munkaterület névjegyeinek megnevezett listája. Minden névjegy a beépített alapértelmezett közönségben van attól a pillanattól, hogy létezik, és a `builtin` az, ami megnevezi azt a sort; a többi a tiéd, hogy létrehozd, feltöltsd és töröld. Az alapértelmezett közönség jön elsőként, utána a többi, a legújabbal kezdve. Ez a verzió listákat kezel és semmit nem küld nekik, így nincs olyan broadcast végpont, amelyet keresni lehetne.

GETapi.openemail.uk/audiences

A valódi hívást futtatja le a munkaterületén, a saját kulcsával.

GET /audiences

A közönség a munkaterület névjegyeinek megnevezett listája. Minden névjegy a beépített alapértelmezett közönségben van attól a pillanattól, hogy létezik, és a builtin az, ami megnevezi azt a sort; a többi a tiéd, hogy létrehozd, feltöltsd és töröld. Az alapértelmezett közönség jön elsőként, utána a többi, a legújabbal kezdve. Ez a verzió listákat kezel és semmit nem küld nekik, így nincs olyan broadcast végpont, amelyet keresni lehetne.

Példa

audiences:read szükséges hozzá. A limit legfeljebb 100 lehet, alapértelmezetten 25.

curl
curl "$OE/audiences" -H "$AUTH"
Válasz
{  "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}

A builtin mezőre ágazz el, ne a névre. Az alapértelmezett közönséget bárki átnevezheti, és a neve az egyetlen dolog, ami változik rajta.

Az alapértelmezett közönség az első olvasáskor jön létre, így az a munkaterület is pontosan egy sort listáz, amely még soha nem hozott létre közönséget.

A contactCount az olvasás pillanatában számolódik, ezért egy létrehozás két oldalán álló két olvasás eggyel eltér. A nevek nem egyediek, ezért azonosítókat tárolj, ne neveket.