تخطَّ إلى المحتوى

بدء ربط قناة

GET /public/v1/social/{integration}

يبدأ ربط قناة جديدة. يولد شارك رابط التفويض الخاص بالمنصة ويعيده؛ وأنت ترسل الشخص إلى هناك ليوافق. وحين يعود، تكون القناة قد ألحقت بمؤسستك.

المعامل مطلوب الوصف
integration نعم اسم المزود، مثل linkedin أو x أو youtube. وهي القيم نفسها التي يعيدها سرد القنوات في identifier.
المعامل مطلوب الوصف
refresh لا معرف قناة قائمة. استخدمه لإعادة ربط تلك القناة بدل إضافة قناة جديدة.
Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/social/linkedin

إعادة ربط قناة قائمة:

Terminal window
curl -H "Authorization: your-api-key" \
"https://dash.sharek.app/api/public/v1/social/linkedin?refresh=channel-id"
{ "url": "https://www.linkedin.com/oauth/v2/authorization?..." }

افتح ذلك الرابط في متصفح. وبعد الموافقة تعيد المنصة التوجيه إلى شارك، فيكمل شارك الربط.

ليست كل قناة تربط بهذه الطريقة

Section titled “ليست كل قناة تربط بهذه الطريقة”
الاستجابة المعنى
400 {"msg": "Integration not allowed"} اسم المزود ليس في القائمة المعروضة. راجع الهجاء مقابل سرد القنوات أو صفحة ربط قنواتك.
400 {"msg": "This integration requires an external URL and is not supported via the public API"} المزود يحتاج رابط نسخة يقدم مسبقًا، وهو ما لا تستطيع هذه العملية جمعه. اربطه من التطبيق بدلًا من ذلك.
402 لا خانات قنوات متبقية لدى المؤسسة. والجسم يحمل url يشير إلى موضع حل المشكلة.
500 {"msg": "Failed to generate auth URL"} لم يستطع شارك بناء رابط المنصة. أعد المحاولة؛ فإن استمر فإعدادات المزود خاطئة.

القنوات التي تعمل هنا هي التي تعيد التوجيه فقط

Section titled “القنوات التي تعمل هنا هي التي تعيد التوجيه فقط”

هذه العملية مبنية للقنوات التي تربط بإرسالك إلى شاشة تسجيل الدخول الخاصة بالمنصة. أما البقية فتربط بجمع بيانات الاعتماد في نموذج أو عبر نافذة داخل التطبيق، ولا يمكن قيادة أي منهما من استدعاء HTTP.