Kalo te dokumentacioni
API

Shtoni kontakte në një audiencë në masë

Vendos deri në 200 kontakte në një audiencë me një thirrje, sipas adresës. Ashtu si shtimi i vetëm, merr adresa që janë tashmë në librin e hapësirës së punës dhe nuk krijon kurrë kontakt: një adresë që nuk është kontakt kthehet te `missing` dhe për të nuk shkruhet asgjë, ndërsa pjesa tjetër e thirrjes kryhet gjithsesi.

POSTapi.openemail.uk/audiences/{id}/contacts/batch

Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.

POST /audiences/{id}/contacts/batch

Vendos deri në 200 kontakte në një audiencë me një thirrje, sipas adresës. Ashtu si shtimi i vetëm, merr adresa që janë tashmë në librin e hapësirës së punës dhe nuk krijon kurrë kontakt: një adresë që nuk është kontakt kthehet te missing dhe për të nuk shkruhet asgjë, ndërsa pjesa tjetër e thirrjes kryhet gjithsesi.

Shembull

Kërkon audiences:write. emails mban 1 deri në 200 adresa, të pastruara nga hapësirat dhe me shkronja të vogla para se të krahasohen.

curl
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch" -H "$AUTH" -H 'content-type: application/json' -d '{  "emails": ["[email protected]", "[email protected]", "[email protected]"]}'
Përgjigje
{  "object": "audience_batch",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "added": 1,  "unchanged": 1,  "missing": ["[email protected]"]}

added numëron anëtarësimet e reja, unchanged kontaktet që ishin tashmë në audiencë, dhe missing liston adresat që nuk janë kontakte, me shkronja të vogla dhe pa përsëritje. Ruajini ato me POST /contacts, ose dërgojini te POST /audiences/{id}/import, që i krijon.

E sigurt për t'u përsëritur. Një thirrje e dytë e njëjtë nuk shton asgjë dhe i raporton të gjithë si unchanged. Shtimi në audiencën e parazgjedhur jep gjithmonë added: 0, sepse çdo kontakt është tashmë në të.

Një emails bosh, më shumë se 200 adresa ose çdo çelës tjetër në trup jep 422, dhe nuk shkruhet asgjë.