بدء ربط قناة
GET /public/v1/social/{integration}يبدأ ربط قناة جديدة. يولد شارك رابط التفويض الخاص بالمنصة ويعيده؛ وأنت ترسل الشخص إلى هناك ليوافق. وحين يعود، تكون القناة قد ألحقت بمؤسستك.
معاملات المسار
Section titled “معاملات المسار”| المعامل | مطلوب | الوصف |
|---|---|---|
integration |
نعم | اسم المزود، مثل linkedin أو x أو youtube. وهي القيم نفسها التي يعيدها سرد القنوات في identifier. |
معاملات الاستعلام
Section titled “معاملات الاستعلام”| المعامل | مطلوب | الوصف |
|---|---|---|
refresh |
لا | معرف قناة قائمة. استخدمه لإعادة ربط تلك القناة بدل إضافة قناة جديدة. |
curl -H "Authorization: your-api-key" \ https://dash.sharek.app/api/public/v1/social/linkedinإعادة ربط قناة قائمة:
curl -H "Authorization: your-api-key" \ "https://dash.sharek.app/api/public/v1/social/linkedin?refresh=channel-id"الاستجابة
Section titled “الاستجابة”{ "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.