Bir Facebook hesabı bağlayın

Parametreler

Gövde

Ad	Tür	Zorunlu	Açıklama
input	object	zorunlu	Wrapper object. The entire request body must be nested under `input`.
input.successUrl	string	zorunlu	URL the user is redirected to after they successfully authorize Facebook. Must be an absolute https URL you control.
input.errorUrl	string	zorunlu	URL the user is redirected to if they cancel or the authorization fails. Must be an absolute https URL you control.

Örnek istek

Yapıştırmaya hazır gövde. Yer tutucu kimlikleri ve değerleri kendi değerlerinizle değiştirin.

Request body

{  "input": {    "successUrl": "https://listingsapi.com/docs/api/connected-accounts-trigger-matches",    "errorUrl": "https://listingsapi.com/docs/api/connected-accounts-connect-facebook"  }}

Yanıtlar

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.

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.

Bir kullanıcının Listings API'ye Facebook sayfalarını toplu olarak yönetme yetkisi vermek için ziyaret edeceği kısa ömürlü bir OAuth URL'si oluşturur. Kullanıcıyı döndürülen url adresine yönlendirin; kullanıcı bu süreçte Facebook'un koşullarını inceleyip kabul eder ve Listings API'nin ihtiyaç duyduğu sayfa yönetimi izinlerini verir. Bağlantı 24 saat geçerlidir.

İstek yapısı. Gövde, successUrl ve errorUrl adlı iki zorunlu alanı içeren bir input nesnesi içinde yer almalıdır. Bunlar, kullanıcı Facebook yetkilendirme akışını tamamladıktan (veya yarıda bıraktıktan) sonra geri yönlendirileceği mutlak https URL'leridir; kendi uygulamanızda başarı durumunda ilk kurulum sürecini devam ettiren ve hata durumunda yeniden deneme seçeneği sunan endpoint'leri iletin. accountId alanı yoktur, bağlantı kurma bağlantısının kapsamı her zaman API anahtarının sahibi olan hesapla sınırlıdır ve accountId (veya bir nesne içine alınmamış düz bir gövde) gönderilmesi HTTP 400 ile reddedilir.

Bu, connect-google endpoint'inin Facebook karşılığı ve toplu bağlantı kurma iş akışının ilk adımıdır. Yetkilendirme tamamlandığında hesap, eşleştirme ve senkronizasyon için kullanılan bir connectedAccountId ile birlikte GET /connected-accounts içinde görünür.

Kullanım senaryosu: bir müşterinin Facebook sayfalarının ilk kurulumu. Bir müşteri Facebook erişimi verdikten sonra müşteriyi döndürülen url adresine yönlendirin. İşlemi tamamladığında POST /connected-accounts/trigger-matches çalıştırın, sonuçları GET /connected-accounts/{connectedAccountId}/connection-suggestions ile inceleyin ve Facebook sayfası verilerinin eşleştirilen Listings API konumlarıyla senkronize edilmeye başlaması için eşleştirmeleri POST /connected-accounts/confirm-matches aracılığıyla onaylayın.

Kullanım senaryosu: izinler reddedildikten sonra yeniden yetkilendirme. Bir kullanıcı zorunlu bir Facebook iznini atlarsa bağlantı senkronizasyon yapamaz. Bağlantıyı yeniden oluşturun ve kullanıcının tüm izinleri vererek yeniden yetkilendirme yapmasını sağlayın.

Google için connect-google endpoint'ini kullanın. url değeri null olmayan bir success: true, bağlantının oluşturulduğu anlamına gelir; errors yalnızca oluşturma işlemi başarısız olduğunda doldurulur.

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" } }'