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

إلغاء الاشتراك من مُرسِل

ما يفعله زر «إلغاء الاشتراك» في صفحة الاشتراكات.

POST/subscriptions/{id}/unsubscribe

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

POST /subscriptions/{id}/unsubscribe

ما يفعله زر «إلغاء الاشتراك» في صفحة الاشتراكات.

مثال

يتطلب threads:write. يلغي الاشتراك بالطريقة التي يطلبها المُرسِل: طلبٌ بنقرة واحدة حين يتيحه، وإلا فرسالةُ إلغاء اشتراك من العنوان الذي وصل إليه البريد. وينقل bin: true أيضًا كل محادثة من المُرسِل إلى سلة المحذوفات. والجسم اختياري.

curl
curl -X POST "$OE/subscriptions/sub_5d2c8e17/unsubscribe" -H "$AUTH" \  -H "Content-Type: application/json" -d '{ "bin": true }'
الاستجابة
{  "object": "unsubscribe",  "subscriptionId": "sub_5d2c8e17",  "method": "one-click",  "url": null,  "binned": 58}

المُرسِل الذي لا يقدّم إلا صفحة يجيب بـ method link والصفحة في url، وعلى شخصٍ أن يفتحها.

المُرسِل الذي لا يتيح أي طريقة لإلغاء الاشتراك يعطي 422 unsubscribe_unsupported، والمُرسِل الذي لم يقبل طلب النقرة الواحدة ولا يعطي عنوانًا يُكتب إليه يعطي 502 unsubscribe_refused. ولم يتغيّر شيء في الحالتين.

المرجع