/api/v4/connected-accounts/connect-facebookHubungkan akun Facebook
Mengembalikan URL OAuth untuk menautkan akun Facebook Pages 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.successUrl | string | wajib | URL the user is redirected to after they successfully authorize Facebook. Must be an absolute https URL you control. |
| input.errorUrl | string | wajib | URL the user is redirected to if they cancel or the authorization fails. Must be an absolute https URL you control. |
Contoh permintaan
Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.
{ "input": { "successUrl": "https://listingsapi.com/docs/api/connected-accounts-trigger-matches", "errorUrl": "https://listingsapi.com/docs/api/connected-accounts-connect-facebook" }}Respons
200OAuth URL generated successfully. Redirect the user to `url` to begin the Facebook authorization flow. The `url` shown is a placeholder; send the user to the `url` returned in your own response.
{ "data": { "bulkConnectLinkForFacebook": { "errors": null, "success": true, "url": "https://connect.example.com/oauth?token=8f3c1d92-..." } }}400Bad request, the body was not wrapped in `input`, or `successUrl`/`errorUrl` was omitted (error message: `Variable "$input" of required type "FacebookOauthBulkInput!" was not provided`).
401Unauthenticated, missing or invalid API key.
Menghasilkan URL OAuth berumur pendek yang dikunjungi pengguna untuk mengizinkan Listings API mengelola Facebook Pages mereka secara massal. Arahkan pengguna ke url yang dikembalikan; selama proses tersebut, mereka meninjau dan menerima ketentuan Facebook serta memberikan izin pengelolaan halaman yang diperlukan Listings API. Tautan ini berlaku selama 24 jam.
Struktur permintaan. Isi permintaan harus dibungkus dalam objek input yang berisi dua field wajib, successUrl dan errorUrl. Keduanya adalah URL https absolut yang menjadi tujuan pengalihan pengguna setelah mereka menyelesaikan (atau membatalkan) proses otorisasi Facebook; berikan endpoint di aplikasi Anda sendiri yang melanjutkan proses orientasi jika berhasil dan menawarkan percobaan ulang jika terjadi kesalahan. Tidak ada field accountId, tautan koneksi selalu dibatasi pada akun pemilik kunci API, dan pengiriman accountId (atau isi permintaan datar tanpa pembungkus) ditolak dengan HTTP 400.
Ini adalah padanan endpoint connect-google untuk Facebook dan merupakan langkah pertama dalam alur kerja koneksi massal. Setelah diotorisasi, akun muncul di GET /connected-accounts dengan connectedAccountId yang digunakan untuk pencocokan dan sinkronisasi.
Kasus penggunaan: menyiapkan halaman Facebook klien. Setelah klien memberikan akses Facebook, arahkan mereka ke url yang dikembalikan. Setelah mereka selesai, jalankan POST /connected-accounts/trigger-matches, tinjau hasilnya dengan GET /connected-accounts/{connectedAccountId}/connection-suggestions, dan konfirmasikan pasangan melalui POST /connected-accounts/confirm-matches agar data Facebook Page mulai disinkronkan dengan lokasi Listings API yang cocok.
Kasus penggunaan: otorisasi ulang setelah izin ditolak. Jika pengguna melewatkan izin Facebook yang wajib diberikan, koneksi tidak dapat melakukan sinkronisasi. Terbitkan ulang tautan tersebut dan minta mereka melakukan otorisasi ulang dengan memberikan semua izin.
Untuk Google, gunakan endpoint connect-google. success: true dengan url yang bukan null berarti tautan telah dihasilkan; errors hanya diisi jika pembuatan tautan gagal.
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/connect-facebook' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "successUrl": "https://listingsapi.com/docs/api/connected-accounts-trigger-matches", "errorUrl": "https://listingsapi.com/docs/api/connected-accounts-connect-facebook" } }'