مساعدة API ميدياويكي
هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.
وثائق وأمثلة: https://www.mediawiki.org/wiki/API
action=createaccount (create)
- هذه الوحدة تتطلب صلاحيات الكتابة.
- هذه الوحدة تقبل طلبات POST فقط.
- المصدر:MediaWiki
- الترخيص: GPL-2.0-or-later
إنشاء حساب مستخدم جديد
الإجراء العام لاستخدام هذه الوحدة هو:
- جلب الحقول المتاحة من action=query&meta=authmanagerinfo مع amirequestsfor=create، $amirequestsfor=create ورمز createaccount من action=query&meta=tokens.
عرض الحقول للمستخدم، والحصول على تقديمها.
- النشر في هذه الوحدة، مع توفير createreturnurl وأية حقول ذات صلة.
- افحص status في الاستجابة.
- إذا تلقيت PASS أو FAIL أنت انتهيت، العملية نجحت أو لم تفعل.
- إذا تلقيت UI، قدم الحقول الجديدة للمستخدم والحصول على تقديمها، ثم انشر في هذه الوحدة باستخدام createcontinue والحقول ذات الصلة المحددة، وكرر الخطوة 4.
- إذا تلقيت REDIRECT، وجه المستخدم إلى redirecttarget وانتظر العودة إلى createreturnurl، ثم انشر في هذه الوحدة باستخدام createcontinue وأية حقول تم تمريرها إلى المسار للعودة ، وكرر الخطوة 4.
- إذا تلقيت RESTART، هذا يعني أن المصادقة ناجحة ولكن ليس لدينا حساب مستخدم مرتبط، قد تعامل هذا كـUI أو كـFAIL.
- createrequests
استخدم فقط طلبات المصادقة هذه، بواسطة id الذي يتم إرجاعه من action=query&meta=authmanagerinfo with amirequestsfor=create أو من رد سابق من هذه الوحدة.
- قيم منفصلة بـ| أو بديل. الحد الأقصى لعدد القيم هو ٥٠ (٥٠٠ للبوتات).
- createmessageformat
تنسيق لاستخدامه في إرسال الرسائل.
- إحدى القيم التالية: html، wikitext، raw، none
- الافتراضي: wikitext
- createmergerequestfields
دمج معلومات الحقل لجميع طلبات التوثيق في مصفوفة واحدة.
- النوع: منطقية (التفاصيل)
- createpreservestate
الحفاظ على الحالة من محاولة تسجيل دخول فاشلة سابقة، إن أمكن.
إذا تم عرض action=query&meta=authmanagerinfo بشكل صحيح لـhasprimarypreservedstate، فقد تم تعليم طلبات primary-required لكي يجب حذفها، إذا عرضت قيمة غير فارغة لـpreservedusername فيجب استخدام اسم المستخدم هذا للوسيط username.
- النوع: منطقية (التفاصيل)
- createreturnurl
يجب أن يكون العودة لتدفقات المصادقة من الجهات الخارجية مطلقا، مطلوب إما هذا أو createcontinue.
عند استلام استجابة REDIRECT، ستفتح عادةً متصفح أو عرض ويب للمسار redirecttargetالمحدد لتدفق مصادقة طرف ثالث، عند اكتمال ذلك، سيرسل الطرف الثالث المتصفح أو عرض الويب إلى هذا المسار، يجب عليك استخلاص أي استعلام أو وسائط POST من المسار وتمريرها كطلب createcontinue إلى وحدة API هذه.
- createcontinue
هذا الطلب استمرار بعد استجابة UI أو REDIRECT سابقة، مطلوب إما هذا أو createreturnurl.
- النوع: منطقية (التفاصيل)
- createtoken
تم استرداد رمز مميز "createaccount" من action=query&meta=tokens
- هذا الوسيط مطلوب.
- *
- تقبل هذه الوحدة معايير إضافية بناءً على طلبات المصادقة المتاحة، استخدم action=query&meta=authmanagerinfo مع amirequestsfor=create (أو استجابة سابقة من هذه الوحدة، إن وُجِدت) لتحديد الطلبات المتاحة والحقول التي يستخدمونها.
- بدء عملية إنشاء المستخدم Example بكلمة المرور ExamplePassword.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [فتح في ملعب]