/api/v4/connected-accounts/disconnect-facebookقطع اتصال حساب Facebook
يقطع اتصال حساب Facebook Pages سبق ربطه بحسابك في Listings API.
المعلمات
النص الأساسي
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| input | object | مطلوب | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountId | string | مطلوب | UUID of the connected Facebook account to disconnect. The whole account is disconnected. |
مثال على الطلب
نص جاهز للصق. استبدل المعرّفات والقيم النموذجية بقيمك.
{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" }}الاستجابات
200Request accepted. `success: true` confirms the disconnect was processed.
{ "data": { "fbBulkDisconnect": { "success": true } }}400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (error message: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.
يفصل الارتباط بين حساب Facebook Pages متصل وحسابك في Listings API. بعد قطع الاتصال، تتوقف إدراجات الأنشطة التجارية التي تُزامَن عبر ذلك الحساب عن تلقي التحديثات من Listings API، وتتوقف تفاعلات Facebook عن الظهور في لوحة التحكم.
بنية الطلب. يجب تغليف جسم الطلب داخل كائن input يكون حقله الوحيد هو connectedAccountId. تُنفَّذ هذه العملية بالكامل أو لا تُنفَّذ، إذ يُقطع اتصال الحساب المتصل بأكمله. لا يوجد حقل locationIds؛ إذ يرفضه المخطط. لفصل إدراج نشاط تجاري لموقع واحد مع إبقاء الحساب متصلًا، استخدم نقطة النهاية disconnect-listing بدلًا من ذلك.
حالة استخدام: إنهاء الخدمة لعميل مغادر. عندما يلغي عميل الخدمة، اقطع اتصال حسابه في Facebook حتى تتوقف Listings API عن إدارة صفحاته ولا تُرسَل أي منشورات أو ردود إضافية نيابةً عنه. قدِّم connectedAccountId الخاص بالعميل (من GET /connected-accounts) لفصل الحساب بالكامل.
حالة استخدام: إعادة منح الإذن لاتصال معطّل. إذا ظهرت في اتصال Facebook أخطاء في بيانات الاعتماد لا تحلّها إعادة المصادقة، فاقطع اتصاله هنا وأنشئ رابطًا جديدًا باستخدام نقطة النهاية connect-facebook. يؤكد success: true قطع الاتصال. بالنسبة إلى Google، استخدم نقطة النهاية disconnect-google. لاحظ أن استجابة success: true تُعاد حتى عندما تكون قيمة connectedAccountId غير معروفة، لذا اعتبر النجاح بمعنى "تمت معالجة الطلب"، وليس دليلًا على إزالة اتصال نشط؛ وتحقَّق من حالة الحساب باستخدام GET /connected-accounts إذا كنت بحاجة إلى التأكد.
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-facebook' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" } }'