المنشآتأنشئ رابط ربط
العودة إلى Sofia

المنشآت

أنشئ رابط ربط

يعيد رابطًا مستضافًا يفوّض فيه الشخص شبكة مع Sofia، فلا يصل أي رمز شبكة إلى تطبيقك. صالح 30 دقيقة، للتطبيق الفعلي فقط.

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

يؤثر هذا الطلب على حسابك الحقيقي.

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

التفويضات

  • Authorizationstringمطلوب

    مفتاحك الشخصي أو رمز وصول OAuth، يُرسل كـ Bearer <token>.

معاملات المسار

  • idstringمطلوب

    معرّف المنشأة.

الجسم

application/json

  • platformstringمطلوب

    الشبكة المراد ربطها

    القيم المسموحة: instagramfacebooktiktoklinkedinx

  • redirectUrlstring

    وجهة الشخص في النهاية، إن تعرفت Sofia على هذا الأصل؛ وإلا تخبره صفحة من Sofia بأن العملية انتهت

الاستجابة

201application/json

رابط الربط المستضاف وتاريخ انتهائه.

  • platformstringمطلوب

    الشبكة المراد ربطها

  • urlstringمطلوب

    صفحة Sofia التي يفتحها الشخص لربط الشبكة

  • expiresAtstringمطلوب

    حتى متى ينتظر الرابط نقرة (ISO 8601)

401

الرمز مفقود أو غير معروف أو منتهي الصلاحية أو ملغى.

402

subscription_required.

403

live_mode_required لتطبيق اختباري، أو أن النطاق accounts:write مفقود.

404

منشأة خارج مساحة عمل الرمز.

409

account_already_connected: الشبكة متصلة بالفعل.

422

platform_not_offered: الشبكة غير متاحة.

4XXapplication/json

أي خطأ آخر، ضمن غلاف الخطأ.