UsahaBuat tautan koneksi
Kembali ke Sofia

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
POST/v1/establishments/{id}/connection-links

Permintaan ini bertindak pada akun asli Anda.

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

Otorisasi

  • Authorizationstringwajib

    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

201application/json

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)

401

Token tidak ada, tidak dikenal, kedaluwarsa, atau dicabut.

402

subscription_required.

403

live_mode_required untuk aplikasi uji, atau scope accounts:write tidak ada.

404

Usaha di luar Workspace token.

409

account_already_connected: jaringan sudah terhubung.

422

platform_not_offered: jaringan tidak ditawarkan.

4XXapplication/json

Kesalahan lain apa pun, dalam amplop kesalahan.