تخطَّ إلى المستندات
API

سرد العناوين الممنوعة

العناوين التي لن ترسل إليها مساحة العمل هذه، الأحدث أولًا.

GETapi.openemail.uk/suppressions

ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.

GET /suppressions

العناوين التي لن ترسل إليها مساحة العمل هذه، الأحدث أولًا.

مثال

يتطلب settings:read، الصلاحية التي تحمي شاشة العناوين المحظورة في الإعدادات. يبحث q في العنوان والسبب والتفاصيل، ويُبقي reason نوعًا واحدًا، ويقسّمها limit وcursor إلى صفحات.

curl
curl "$OE/suppressions?reason=complaint" -H "$AUTH"
الاستجابة
{  "object": "list",  "data": [{      "object": "suppression",      "id": "7b1e2c3d-4f5a-4b6c-8d7e-9f0a1b2c3d4e",      "email": "[email protected]",      "reason": "complaint",      "detail": "abuse",      "removable": true,      "createdAt": "2026-09-12T08:41:03.000Z"    }],  "hasMore": false,  "nextCursor": null}

يُرفض الإرسال إلى عنوان ممنوع لذلك المستلم قبل أن يخرج أي شيء، والرسالة التي كل مستلميها ممنوعون تفشل تمامًا. ويضع الارتداد الدائم أو الشكوى العنوان هنا من تلقاء نفسه.

القائمة ملك لمساحة العمل كلها، لذا فالمفتاح المقصور على عناوين أو نطاقات بعينها يقرؤها كاملة. والصف يسمّي المستلم ولا يسمّي أبدًا أيًّا من عناوينك أرسل إليه.