الانتقال إلى المحتوى الرئيسي
يمكن للمُدمِجين المشتركين في خطة Business أو Enterprise إعداد حسابات التواصل الاجتماعي لعملائهم ضمن ملفات فرعية. باستخدام خادم MCP، ينشئ الوكيل ملفًا فرعيًا، ويستهدفه، ثم يُصدر رابط تسجيل دخول أحادي للربط يفتحه العميل لربط حساباته.

سير العمل

1

إنشاء ملف فرعي

استدعِ create_profile (على مستوى الحساب — بدون profileKey). يُعيد الاستدعاء مفتاح ملف شخصي للملف الفرعي الجديد.
2

استهداف الملف الفرعي

استخدم مفتاح الملف الشخصي المُعاد في الاستدعاءات اللاحقة — إما عبر ترويسة Profile-Key على الاتصال أو كوسيط profileKey لكل استدعاء. راجع الاتصال والإعداد للاطلاع على أولوية الأسبقية.
3

إصدار رابط ربط حسابات التواصل

استدعِ generate_jwt_social_linking_url لإصدار رابط تسجيل دخول أحادي للربط. يُشتق مفتاح توقيع JWT ونطاق الإعداد من جهة الخادم — لا يُقدم المستدعي أي ترويسات X-Ayrshare-* ولا أي مفتاح خاص أو نطاق.
4

يقوم العميل بربط حساباته

يفتح العميل الرابط ويُصرّح (OAuth) لحساباته على شبكات التواصل الاجتماعي. تُربط الحسابات المتصلة بالملف الفرعي.

المتطلبات

generate_jwt_social_linking_url يتطلب profileKey. إذا لم يُحل أي منها، يُعيد الاستدعاء 400 مع الرسالة “Profile Key is required…”.يجب تزويد نطاق ربط حسابات التواصل لحسابك. هذا متاح ضمن خطتَي Business وEnterprise.

حالات الخطأ

الخطوات التالية

الاتصال والإعداد

المصادقة واستهداف الملف الشخصي.

فهرس الأدوات

الأدوات الـ 27 مُجمَّعة حسب النطاق، مع الغرض والصلاحيات.