مساعدة API ميدياويكي

هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.

وثائق وأمثلة: https://www.mediawiki.org/wiki/API

action=linkaccount (link)

(main | linkaccount)
  • هذه الوحدة تتطلب صلاحيات الكتابة.
  • هذه الوحدة تقبل طلبات POST فقط.
  • المصدر:MediaWiki
  • الترخيص: GPL-2.0-or-later

ربط حساب من موفر طرف ثالث للمستخدم الحالي.

الإجراء العام لاستخدام هذه الوحدة هو:

  1. جلب الحقول المتاحة من action=query&meta=authmanagerinfo مع amirequestsfor=link، $amirequestsfor=link ورمز csrf من action=query&meta=tokens.

عرض الحقول للمستخدم، والحصول على تقديمها.

  1. النشر في هذه الوحدة، مع توفير linkreturnurl وأية حقول ذات صلة.
  2. افحص status في الاستجابة.
    • إذا تلقيت PASS أو FAIL أنت انتهيت، العملية نجحت أو لم تفعل.
    • إذا تلقيت UI، قدم الحقول الجديدة للمستخدم والحصول على تقديمها، ثم انشر في هذه الوحدة باستخدام linkcontinue والحقول ذات الصلة المحددة، وكرر الخطوة 4.
    • إذا تلقيت REDIRECT، وجه المستخدم إلى redirecttarget وانتظر العودة إلى linkreturnurl، ثم انشر في هذه الوحدة باستخدام linkcontinue وأية حقول تم تمريرها إلى المسار للعودة ، وكرر الخطوة 4.
    • إذا تلقيت RESTART، هذا يعني أن المصادقة ناجحة ولكن ليس لدينا حساب مستخدم مرتبط، قد تعامل هذا كـUI أو كـFAIL.
وسائط:
linkrequests

استخدم فقط طلبات المصادقة هذه، بواسطة id الذي يتم إرجاعه من action=query&meta=authmanagerinfo with amirequestsfor=link أو من رد سابق من هذه الوحدة.

قيم منفصلة بـ| أو بديل.
Maximum number of values is 50 (500 for clients allowed higher limits).
linkmessageformat

تنسيق لاستخدامه في إرسال الرسائل.

إحدى القيم التالية: html، none، raw، wikitext
Default: wikitext
linkmergerequestfields

دمج معلومات الحقل لجميع طلبات التوثيق في مصفوفة واحدة.

Type: boolean (details)
linkreturnurl

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

عند استلام استجابة REDIRECT، ستفتح عادةً متصفح أو عرض ويب للمسار redirecttargetالمحدد لتدفق مصادقة طرف ثالث، عند اكتمال ذلك، سيرسل الطرف الثالث المتصفح أو عرض الويب إلى هذا المسار، يجب عليك استخلاص أي استعلام أو وسائط POST من المسار وتمريرها كطلب linkcontinue إلى وحدة API هذه.

linkcontinue

هذا الطلب استمرار بعد استجابة UI أو REDIRECT سابقة، مطلوب إما هذا أو linkreturnurl.

Type: boolean (details)
linktoken

تم استرداد رمز مميز "csrf" من action=query&meta=tokens

This parameter is required.
*
تقبل هذه الوحدة معايير إضافية بناءً على طلبات المصادقة المتاحة، استخدم action=query&meta=authmanagerinfo مع amirequestsfor=link (أو استجابة سابقة من هذه الوحدة، إن وُجِدت) لتحديد الطلبات المتاحة والحقول التي يستخدمونها.
أمثلة:
بدء عملية ربط حساب من Example.
api.php?action=linkaccount&provider=Example&linkreturnurl=http://example.org/&linktoken=123ABC [فتح في ملعب]
مجلوبة من "https://www.mazra3a.net/wiki/خاص:مساعدة_إيه_بي_آي"