پرش به مستندات
API

فهرست اشتراک‌ها

خبرنامه‌ها و فهرست‌های پستی‌ای که صندوق پستی دریافت می‌کند، همان‌طور که صفحهٔ اشتراک‌ها نشانشان می‌دهد.

GET/subscriptions

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

GET /subscriptions

خبرنامه‌ها و فهرست‌های پستی‌ای که صندوق پستی دریافت می‌کند، همان‌طور که صفحهٔ اشتراک‌ها نشانشان می‌دهد.

نمونه

به threads:read نیاز دارد. یک فرستنده وقتی اشتراک به شمار می‌آید که نامه‌اش هدر List-Unsubscribe داشته باشد، با یک ردیف برای هر نشانی‌ای که به آن می‌نویسد. status یا active است، که پیش‌فرض است، یا unsubscribed، q در فرستنده جست‌وجو می‌کند، و sort یکی از recent، most، unread یا name است.

curl
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 آن را به یک نشانی محدود می‌کند.

مرجع