Skip to main content
POST
أنشئ رابط ربط للشبكات الاجتماعية لملف مستخدم. لا يزال اسم نقطة النهاية generateJWT، لكن التوكن الذي تُعيده معتّم وليس JWT. انظر نظرة عامة على رابط الربط لمزيد من التفاصيل.
رابط الربط صالح لمدة 5 دقائق. بعد 5 دقائق يجب توليد رابط الربط جديد. انظر معامل Max Pack expiresIn لمعرفة الخيارات الإضافية.
الـ token المُعاد هو سلسلة معتّمة تبدأ بـ ayr_ls_؛ فهو ليس JWT قابلًا لفك التشفير ولا يحمل أي حِمل قابل للقراءة. أرسل url إلى مستخدمك كما هي، وتعامل مع token كبيانات اعتماد تحفظها لا تفحصها. الروابط التي أنشأتها سابقًا لا تزال تعمل.ينفّذ POST /profiles/link-sessions العملية نفسها بدون المعاملات القديمة، ويتيح كذلك التحقق من رابط أو إبطاله. راجع إنشاء Link Session.

معاملات الترويسة

string
مفتاح X API الخاص بك (Consumer Key) من X Developer Portal. بديل لمعامل الجسم twitterApiKey. عند تزويده، سيستخدم رابط الربط المُولَّد تطبيق X Developer الخاص بك في ربط OAuth.
string
X API Secret الخاص بك (Consumer Secret) من X Developer Portal. بديل لمعامل الجسم twitterApiSecret. مطلوب عند تزويد X-Twitter-OAuth1-Api-Key.
موصى به: مرّر بيانات اعتماد X عبر الترويسات (X-Twitter-OAuth1-Api-Key وX-Twitter-OAuth1-Api-Secret) للاتساق مع بقية نقاط نهاية Ayrshare API. لا يزال معامَلا الجسم twitterApiKey وtwitterApiSecret مدعومَين للتوافق مع الإصدارات السابقة.

معاملات الجسم

string
نطاق التطبيق. يُرجى استخدام النطاق نفسه الذي زُوّدت به أثناء الإعداد.اختياري. إذا أُغفل، يُستخدم نطاق حسابك نفسه. وإذا أرسلته، فيجب أن يكون نطاقًا مسجّلًا على حسابك.
string
مهمل
لم يُعد مستخدمًا. يُقبل هذا الحقل ويُتجاهل، لذا تستمر عمليات التكامل الحالية في العمل دون أي تغيير.لم تُعد روابط الربط موقّعة، لذا لا يوجد مفتاح لإرساله. يمكنك إزالة هذا الحقل والتوقف عن تخزين المفتاح الخاص لهذا الغرض.
string
مطلوب
Profile Key الخاص بالمستخدم. لا يمكن استخدام مفتاح API في هذا الحقل.
boolean
افتراضي:false
تسجيل الخروج التلقائي من الجلسة الحالية. لا يُنصح باستخدامه في بيئة الإنتاج لأنه يؤثر على الأداء.انظر تسجيل الخروج التلقائي من جلسة ملف تعريف لمزيد من المعلومات.
string
حدّد رابطًا لإعادة التوجيه إليه عند النقر على زر “Done” أو صورة الشعار. سيُختصر الرابط تلقائيًا في رابط الربط المُعاد. أعد توجيه نافذة الأصل الفاتحة بإضافة معامل الاستعلام origin=true إلى رابط إعادة التوجيه.
array
حدّد شبكات التواصل الاجتماعي المراد عرضها في صفحة الربط. سيتجاوز هذا شبكات التواصل الاجتماعي المُهيَّأة في صفحة Social Networks.
Only display Facebook, X/Twitter, LinkedIn, and TikTok
تجاوز طريقة ربط إنستجرام المستخدمة عند نقر المستخدم على زر إنستجرام في صفحة الربط لهذا الرابط. القيم الصالحة:
  • instagram: تسجيل دخول إنستجرام المباشر، دون الحاجة إلى صفحة فيسبوك.
  • facebook: ربط إنستجرام عبر صفحة فيسبوك متصلة.
Force direct Instagram Login for this linking session
إذا حُذف، تستخدم صفحة الربط إعداد Instagram Login على مستوى حسابك.انظر Instagram Link Method لمزيد من المعلومات.
boolean
مهمل
لم يُعد مستخدمًا. يُقبل هذا الحقل ويُتجاهل.لا يوجد توكن موقّع للتحقق منه: يتم التحقق من token المُعاد عبر صفحة الربط عندما يفتح المستخدم الرابط.
boolean
مهمل
لم يُعد مستخدمًا. يُقبل هذا الحقل ويُتجاهل، لأن privateKey لم يُعد يُقرأ.
number
افتراضي:5
حدّد مدة صلاحية الرمز بالدقائق. النطاق: من 1 دقيقة إلى 2880 دقيقة.انظر JWT Expires In لمزيد من المعلومات.
object
افتراضي:5
أرسل بريد Connect Accounts يتضمن رابطًا يتيح للمستخدمين الوصول مباشرةً إلى صفحة الربط الاجتماعي الخاصة بهم.انظر بريد Connect Accounts لمزيد من المعلومات.
عند تضمين بيانات اعتماد X API الخاصة بك، سيبدأ رابط الربط المُولَّد ربط OAuth باستخدام تطبيق X Developer الخاص بك. سيرى المستخدمون النهائيون اسم تطبيقك على شاشة موافقة X.
مطلوب: قبل استخدام هذه الميزة، يجب إضافة روابط callback التالية إلى إعدادات تطبيق X Developer الخاص بك (ضمن Authentication settings > Callback URI / Redirect URL):
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
بدون ذلك، سيفشل تدفق OAuth بالخطأ 403 Callback URL not approved.