API:Account creation/ar

إنشاء حساب
هذه العملية تنقسم إلى ثلاثة أقسام:


 * 1) استدعاء الحقول من  والإشارة من.
 * 2) إرسال طلب POST مستخدما الإشارة المجلوبة مع معلومات المستخدم وحقول أخرى، ورد معرف الموارد الموحد إلى واجهة برمجة التطبيقات.
 * 3) التعامل مع الرد، الذي قد يتطلب طلبات POST أخرى لإضافة مزيد من المعلومات.

مثال 1: عملية على موقع ويكي لا يحتوي على امتدادات تصديق خاصة
تكون الأمور على موقع ويكي لا يستخدم امتدادات تصديق خاصة أيسر وأقصر زمنا. لو كان كودك البرمجي يعلم ما هي الحقول المطلوبة، قد يتخطى الاستدعاء من ويفترض ما هي الحقول المطلوبة (أي اسم المستخدم وكلمة المرور وإعادة إدخال كلمة المرور وعنوان البريد الإلكتروني وربما يطلب الاسم الحقيقي).

مثال 2: عملية على موقع ويكي يستخدم امتداد CAPTCHA
لاحظ أن الخطوة الأولى تاليا، إن كنت ترغب، يمكن تقسيمها إلى خطوتين: خطوة أولى لجلب الحقول المتاحة من وخطوة أخرى لجلب الإشارة من.

عينة من الكود البرمجي
لاحظ أن هذه العينة من الكود البرمجي تفصل بين طلبي و ، وتفترض بوجه عام وجود CAPTCHA ولا تعقيدات أخرى.

الخطوة الأولى: جلب الحقول المتاحة من والإشارة من
خطوة جلب و  بوجه عام لا تتغير كثيرا عن المثال السابق، ولهذا السبب لن نكررها هنا. The list of requests returned by will include definitions for both the CAPTCHA extension and the OpenID extension.

Second step: Answer the CAPTCHA and select OpenID authentication.
The client would be expected to redirect the user's browser to the provided redirecttarget.

The OpenID provider would authenticate, and redirect to Special:OpenIDConnectReturn on the wiki, which would validate the OpenID response and then redirect to the createreturnurl provided in the first POST to the API with the code and state parameters added.

The client gets control of the process back at this point and makes its next API request.

Third step: Back from OpenID.
The client posts the code and state back to the API. The API's response has the two-factor authentication extension prompting the user to set up their second factor.

Now the client would prompt the user to set up a new account in their two-factor authentication app and enter the current code, or allow the user to skip 2FA setup. Let's assume the user does set up 2FA.

Fourth step: Set up two-factor authentication.
The account creation has finally succeeded.

If at any point account creation fails, a response with status FAIL will be returned, along with a message to display to the user.

Additional notes

 * Account creations are recorded in Special:log/newusers.

إذا سجلت الدخول، فسيتم تسجيل اسم المستخدم أيضا عند إنشاء حساب.


 * While executing the code snippets provided on this page, remember:
 * Once an account on a wiki is created, it cannot be deleted.
 * Always use as the endpoint, so that you don't accidentally create accounts on production wikis.
 * MediaWiki site administrators and extension developers can disable this API feature by inserting the following line in the configuration file:

أنظر أيضا