Usaha

Buat tautan koneksi

Mengembalikan tautan terhosting tempat orang mengotorisasi jaringan di Sofia, sehingga token jaringan tak sampai ke aplikasi Anda. Berlaku 30 menit.

POSThttps://api.sofia-post.com/api/v1/establishments/{id}/connection-links

Buat tautan koneksi

curl -X POST 'https://api.sofia-post.com/api/v1/establishments/{id}/connection-links' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"platform":"tiktok","redirectUrl":"https://crm.example.com/sofia/connected"}'

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

Buat tautan koneksi

curl --request POST \
  --url 'https://api.sofia-post.com/api/v1/establishments/<id>/connection-links' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "platform": "tiktok",
  "redirectUrl": "https://crm.example.com/sofia/connected"
}'

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

Buat tautan koneksi terhosting dan arahkan pemilik ke sana. Tautan berlaku 30 menit; di akhir, Sofia mengembalikannya ke redirectUrl Anda jika dia mengenali asalnya.

curl -X POST https://api.sofia-post.com/api/v1/establishments/$ESTABLISHMENT_ID/connection-links \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"platform":"linkedin","redirectUrl":"https://app.example.com/sofia/connected"}'

Jaringan yang sudah terhubung menjawab 409 account_already_connected; jaringan yang tidak ditawarkan Sofia menjawab 422 platform_not_offered.

Otorisasi

Authorizationstringheaderwajib
Kunci pribadi atau access token OAuth Anda, dikirim sebagai Bearer <token>.

Parameter path

idstringwajib
Pengenal usaha.

Body

application/json

platformstringwajib
Jaringan yang akan dihubungkan
Nilai yang diizinkan: instagramfacebooktiktoklinkedinx
redirectUrlstring
Tujuan orang di akhir, bila Sofia mengenali origin ini; jika tidak, halaman Sofia memberi tahu bahwa proses selesai

Respons

Tautan koneksi terhosting beserta masa berlakunya.

platformstringwajib
Jaringan yang akan dihubungkan
urlstringwajib
Halaman Sofia yang dibuka orang untuk menghubungkan jaringan
expiresAtstringwajib
Sampai kapan tautan menunggu klik (ISO 8601)

Apakah halaman ini membantu?