Collega un account Facebook

Parametri

Corpo

Nome	Tipo	Obbligatorio	Descrizione
input	object	obbligatorio	Wrapper object. The entire request body must be nested under `input`.
input.successUrl	string	obbligatorio	URL the user is redirected to after they successfully authorize Facebook. Must be an absolute https URL you control.
input.errorUrl	string	obbligatorio	URL the user is redirected to if they cancel or the authorization fails. Must be an absolute https URL you control.

Risposte

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.

Genera un URL OAuth di breve durata che un utente visita per autorizzare Listings API a gestire in blocco le sue pagine Facebook. Reindirizza l'utente al url restituito; durante la procedura, l'utente esamina e accetta i termini di Facebook e concede le autorizzazioni per la gestione delle pagine necessarie a Listings API. Il link è valido per 24 ore.

Struttura della richiesta. Il corpo deve essere racchiuso in un oggetto input contenente due campi obbligatori, successUrl e errorUrl. Si tratta degli URL https assoluti a cui l'utente viene reindirizzato dopo aver completato (o abbandonato) la procedura di autorizzazione di Facebook; passa endpoint della tua applicazione che riprendano la procedura di configurazione iniziale in caso di esito positivo e offrano la possibilità di riprovare in caso di errore. Non esiste un campo accountId, il link di collegamento è sempre limitato all'account a cui appartiene la chiave API e l'invio di accountId (o di un corpo piatto, non racchiuso nell'oggetto) viene rifiutato con uno stato HTTP 400.

Questo è l'equivalente per Facebook dell'endpoint connect-google e il primo passaggio del flusso di collegamento in blocco. Una volta autorizzato, l'account compare in GET /connected-accounts con un connectedAccountId utilizzato per l'abbinamento e la sincronizzazione.

Caso d'uso: configurazione iniziale delle pagine Facebook di un cliente. Dopo che un cliente ha concesso l'accesso a Facebook, reindirizzalo al url restituito. Quando ha terminato, esegui POST /connected-accounts/trigger-matches, esamina i risultati con GET /connected-accounts/{connectedAccountId}/connection-suggestions e conferma gli abbinamenti tramite POST /connected-accounts/confirm-matches affinché inizi la sincronizzazione dei dati delle pagine Facebook con le sedi Listings API abbinate.

Caso d'uso: nuova autorizzazione dopo il rifiuto delle autorizzazioni. Se un utente salta un'autorizzazione Facebook obbligatoria, la connessione non può effettuare la sincronizzazione. Genera nuovamente il link e chiedigli di ripetere la procedura di autorizzazione concedendo tutte le autorizzazioni.

Per Google, usa l'endpoint connect-google. success: true con un url non nullo indica che il link è stato generato; errors viene valorizzato solo se la generazione non riesce.

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

Parametri

Corpo

Richiesta di esempio

Risposte