API

Bir toplu gönderimin tek bir kopyasını alma

Bir kişinin kopyası: `GET /broadcasts/{id}/recipients` tarafından listelenen aynı satır, artı birleştirme alanları doldurulmuş ve kişinin kendi abonelikten çıkma bağlantısıyla, o kişinin aldığı haliyle konu, HTML ve metin.

GETapi.openemail.uk/broadcasts/{id}/recipients/{emailId}

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

GET /broadcasts/{id}/recipients/{emailId}

Bir kişinin kopyası: GET /broadcasts/{id}/recipients tarafından listelenen aynı satır, artı birleştirme alanları doldurulmuş ve kişinin kendi abonelikten çıkma bağlantısıyla, o kişinin aldığı haliyle konu, HTML ve metin.

Örnek

emails:read gerekir. emailId, alıcı listesinden gelen kopyanın emailId değeridir. Yanıt burada kısaltılmıştır.

curl

curl "$OE/broadcasts/brd_5a8c1e3f7b2d94a06c8e1f3b/recipients/msg_01dad25067bc4dac966d515d" -H "$AUTH"

Yanıt

{  "object": "broadcast_recipient",  "emailId": "msg_01dad25067bc4dac966d515d",  "email": "[email protected]",  "name": "Ada Lovelace",  "status": "sent",  "deliveredAt": "2026-09-23T12:00:11.000Z",  "opens": 3,  "clicks": 1,  "unsubscribedAt": null,  "subject": "Ada, the September release is out",  "html": "<p>Hi Ada,</p><p>Here is what changed this month.</p>",  "text": "Hi Ada, here is what changed this month. Unsubscribe: https://…"}

HTML, açma ve tıklama izlemesi eklenmeden önceki halidir; yani izleme pikselini ve yeniden yazılmış bağlantıları taşıyan baytlar değil, birleştirme alanları doldurulmuş olarak sizin yazdığınızdır.

Bu toplu gönderimin kopyası olmayan bir emailId, çalışma alanındaki başka bir e-postayı gösterse bile 404 recipient_not_found döner.

Retler

Durum	Kod	Ne zaman
400	`invalid_cursor`	Alıcı listesinde, o listenin vermediği bir `cursor`.
403	`insufficient_scope`	Anahtarda `emails:read` yok.
404	`broadcast_not_found`	Kimlik bu çalışma alanında hiçbir toplu gönderimi adlandırmıyor ya da anahtar belirli adreslerle veya alan adlarıyla sınırlı ve toplu gönderim onun sahip olmadığı birinden gönderilmiş.
404	`recipient_not_found`	`GET /broadcasts/{id}/recipients/{emailId}` üzerinde, bu toplu gönderimin kopyası olmayan bir `emailId`.