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

المنشآت

أنشئ رابط ربط

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

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

أنشئ رابط ربط

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

التفويضات

Authorizationstringمطلوب

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

يبقى في هذا التبويب فقط، ويُرسل إلى api.sofia-post.com فقط. احصل على مفتاح API

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

idstringمطلوب

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

الجسم

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

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

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

الشبكة المرتبطة أصلًا ترد بـ 409 account_already_connected؛ والشبكة التي لا تقترحها Sofia ترد بـ 422 platform_not_offered.

التفويضات

  • Authorizationstringheaderمطلوب

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

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

  • idstringمطلوب

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

الجسم

application/json
  • platformstringمطلوب

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

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

  • redirectUrlstring

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

الاستجابة

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

  • platformstringمطلوب

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

  • urlstringمطلوب

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

  • expiresAtstringمطلوب

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

هل كانت هذه الصفحة مفيدة؟