سرد الاشتراكات
النشرات البريدية والقوائم البريدية التي يستقبلها صندوق البريد، كما تعرضها صفحة الاشتراكات.
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
GET /subscriptions
النشرات البريدية والقوائم البريدية التي يستقبلها صندوق البريد، كما تعرضها صفحة الاشتراكات.
مثال
يتطلب threads:read. يكون المُرسِل اشتراكًا حين يحمل بريده ترويسة List-Unsubscribe، مع صفّ لكل عنوان يراسله. وتكون status إما active، وهي القيمة الافتراضية، أو unsubscribed، ويبحث q في المُرسِل، وتكون sort إحدى recent أو most أو unread أو name.
curl "$OE/subscriptions?sort=most&limit=1" -H "$AUTH"{ "object": "list", "data": [{ "object": "subscription", "id": "sub_5d2c8e17", "senderEmail": "[email protected]", "senderName": "Figma", "recipient": "[email protected]", "status": "active", "method": "one-click", "linkUrl": "https://www.figma.com/unsubscribe?u=4f1c", "unread": 12, "recent": 4, "total": 58, "sinceUnsubscribed": 0, "lastSeenAt": "2026-10-01T07:02:41.000Z", "unsubscribedAt": null, "unsubscribedWith": null, "future": null }], "total": 37, "counts": { "active": 37, "unsubscribed": 9 }, "hasMore": true}يعدّ recent بريد آخر 30 يومًا، وsinceUnsubscribed البريد الذي ظلّ يصل بعد أن ألغيت الاشتراك، ويسمّي future القاعدة التي تواصل نقل بريده الجديد، حين توجد.
يتنقّل limit، وهو 50 ما لم تقل غير ذلك و200 على الأكثر، وoffset بين صفحاتها. ويعدّ total كل صفّ مطابق، وcounts كم منها نشط وكم أُلغي الاشتراك فيه.
المفتاح أو التطبيق المقيّد بعناوين معيّنة لا يسرد إلا الاشتراكات التي تُسلَّم إليها، ويضيّق address ذلك إلى عنوان واحد.