/api/v4/connected-accounts/disconnect-facebookPutuskan koneksi akun Facebook
Memutuskan koneksi akun Facebook Pages yang sebelumnya terhubung ke akun Listings API Anda.
Parameter
Body
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| input | object | wajib | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountId | string | wajib | UUID of the connected Facebook account to disconnect. The whole account is disconnected. |
Contoh permintaan
Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.
{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" }}Respons
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.
Memutus tautan antara akun Facebook Pages yang terhubung dan akun Listings API Anda. Setelah koneksi diputus, profil bisnis yang disinkronkan melalui akun tersebut berhenti menerima pembaruan dari Listings API dan interaksi Facebook tidak lagi muncul di dasbor.
Struktur permintaan. Body harus dibungkus dalam objek input yang hanya memiliki field connectedAccountId. Operasi ini bersifat menyeluruh atau tidak dilakukan sama sekali; koneksi seluruh akun yang terhubung akan diputus. Tidak ada field locationIds; field tersebut ditolak oleh skema. Untuk memutus koneksi profil bisnis pada satu lokasi sambil tetap mempertahankan koneksi akun, gunakan endpoint disconnect-listing.
Kasus penggunaan: mengakhiri layanan untuk klien yang berhenti berlangganan. Saat klien membatalkan langganan, putuskan koneksi akun Facebook mereka agar Listings API berhenti mengelola halaman mereka dan tidak ada lagi postingan atau balasan yang dikirim atas nama mereka. Berikan connectedAccountId milik klien (dari GET /connected-accounts) untuk memutus koneksi akun sepenuhnya.
Kasus penggunaan: mengotorisasi ulang koneksi yang bermasalah. Jika koneksi Facebook mengalami kesalahan kredensial yang tidak dapat diatasi dengan autentikasi ulang, putuskan koneksinya di sini lalu buat tautan baru menggunakan endpoint connect-facebook. success: true mengonfirmasi pemutusan koneksi. Untuk Google, gunakan endpoint disconnect-google. Perhatikan bahwa respons success: true tetap dikembalikan bahkan untuk connectedAccountId yang tidak dikenal, jadi anggap keberhasilan sebagai "permintaan telah diproses", bukan bukti bahwa koneksi aktif telah dihapus; konfirmasikan status akun dengan GET /connected-accounts jika Anda memerlukan kepastian.
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" } }'