API:Account creation/ar

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


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

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

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

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

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

الخطوة الثانية: الإجابة على CAPTCHA واختيار تصديق OpenID.
نتوقع من الجهاز العميل إعادة توجيه متصفح المستخدم إلى صفحة redirecttarget المحددة.

سيتولى مقدم خدمة OpenID التصديق ومن ثم إعادة التوجيه إلى صفحة Special:OpenIDConnectReturn على موقع الويكي، التي سوف تتولى التثبت من رد OpenID ومن ثم إعادة التوجيه إلى createreturnurl شريطة أن تضاف المتغيرات code و state إلى طلب POST الأول المقدم إلى واجهة برمجية التطبيقات.

ستنتقل السيطرة على العملية إلى جهاز العميل مرة أخرى عند هذه الخطوة ومن ثم يرسل طلب واجهة برمجة التطبيقات التالي.

الخطوة الثالثة: رجوعا من OpenID.
سوف يرسل جهاز العميل كلا من code و state إلى واجهة برمجة التطبيقات. سيعرض رد واجهة برمجة التطبيقات امتداد المصادقة باستخدام عاملين اثنين الذي يحث المستخدم على إعداد العامل الثاني للمصادقة.

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

الخطوة الرابعة: إعداد التصديق باستخدام عاملين اثنين.
تكللت عملية إنشاء حساب بالنجاح.

لو حدث في أي خطوة وفشلت عملية إنشاء الحساب، سوف يعرض رد مع الحالة FAIL وكذلك message تعرض على المستخدم.

ملاحظات إضافية

 * تسجل أعمال إنشاء الحسابات في صفحة Special:log/newusers.

لو كنت مسجل الدخول، سوف يسجل اسم مستخدمك أيضا حينما تنشئ حساب.


 * بينما تنفذ قصاصات الكود البرمجي المبينة في هذه الصفحة، تذكر ما يلي:
 * حال إنشاء حساب على موقع ويكي، لا يمكن محو هذا الحساب.
 * استخدم دائما ليكون نقطة النهاية، حتى لا تنشئ حسابات دون قصد على مواقع ويكي الإنتاج.
 * يمكن لكلا من إداري موقع و مطوري امتدادات ميدياويكي تعطيل سمة واجهة برمجة التطبيقات هذه عن طريق إضافة السطر التالي إلى ملف الضبط: