Synupv1
Criar chave
v1Recursos/Connections/getObter uma URL de conexão do Facebook

Obter uma URL de conexão do Facebook

Retorna uma URL de autorização OAuth do Facebook para abrir em um navegador e conectar a Página do Facebook deste local. Este endpoint não pode concluir a conexão sozinho — a tela de consentimento do Facebook requer um humano interativo.

get/api/v1/connections/facebook/connect-url
connections:write
Parâmetros de consulta
locationIdstringobrigatório
O local a conectar.
clientIdstringopcional
O cliente do local. Necessário apenas para desambiguar quando sua chave é limitada a clientes específicos.
returnUrlstringopcional
Caminho interno do app para onde ir após o humano concluir a tela de consentimento. Padrão: "/".
Resposta
dataobjectopcional
providerstring (google | facebook)opcional
Qual publisher esta URL conecta.
locationIdstringopcional
O local ao qual esta conexão será pareada assim que aprovada.
urlstringopcional
A URL de autorização — abra-a em um navegador sob o controle do proprietário da conta.
notestringopcional
Explica que não há callback para sua integração; consulte GET /api/v1/connections depois.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/connections/facebook/connect-url
Sua chave de API
locationId *
clientId
returnUrl
{
  "data": {
    "provider": "facebook",
    "locationId": "loc_456",
    "url": "https://www.facebook.com/v19.0/dialog/oauth?client_id=...&redirect_uri=...&scope=...&state=...&response_type=code",
    "note": "Open this URL in a browser under the account owner's control. There is no callback to your integration — once approved, poll GET /api/v1/connections to see the new connection."
  }
}