Ugrás a dokumentációra
API

Egy közönség névjegyeinek listázása

Maguk a névjegyek, nem a tagsági rekordok, ugyanabban a sorrendben, mint a névjegylistában: a legutóbb látottak elöl, a soha nem levelezettek a végén. A `limit` legfeljebb 200 lehet, alapértelmezetten 50. Az alapértelmezett közönség olvasása itt a teljes címjegyzéket adja vissza.

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

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

GET /audiences/{id}/contacts

Maguk a névjegyek, nem a tagsági rekordok, ugyanabban a sorrendben, mint a névjegylistában: a legutóbb látottak elöl, a soha nem levelezettek a végén. A limit legfeljebb 200 lehet, alapértelmezetten 50. Az alapértelmezett közönség olvasása itt a teljes címjegyzéket adja vissza.

Példa

Önmagában az audiences:read elég hozzá, contacts:read nélkül.

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"
Válasz
{  "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"}

Az audiences:read hatókörrel rendelkező kulcs contacts:read nélkül is kiolvassa egy közönség címeit. Tudatosan add ki.

Az a névjegy, amely egyetlen saját közönségedben sincs benne, akkor is az alapértelmezettben van, így a címjegyzékből semmi nem láthatatlan ezen az útvonalon.