מדיה ויקי:Api-help-authmanager-general-usage
מתוך אגרון - וויקיפדיה
הנוהל הכללי לשימוש במודול הזה הוא:
- אחזור השדות הזמינים מ־action=query&meta=authmanagerinfo עם amirequestsfor=$4 ואסימון $5 מתוך action=query&meta=tokens.
- הצגת השדות למשתמש וקבלת אישור ממנו.
- שליחה (Post) למודול הזה עם $1returnurl וכל השדות הרלוונטיים.
- בדיקת ה־status בתשובה.
- אם קיבלת PASS או FAIL, זה הסיום. הפעולה שלך הצליחה או נכשלה.
- אם קיבלת UI, יש להציג את השדות החדשים למשתמש ולקבל את מה שהוא ישלח. אחר־כך יש לשלוח (post) למודול הזה עם $1continue ועם הגדרות של השדות הרלוונטיים ולחזור על צעד 4.
- אם קיבלת REDIRECT, יש להפנות את המשתמש ל־redirecttarget ולחכות לחזרה אל $1returnurl. אחר־כך לשלוח (post) למודול הזה עם $1continue ועם כל השדות שהועברו ל־URL שחוזרים אליו ולחזור על צעד 4.
- אם קיבלת RESTART, זה אומר שהאימות עבד אבל אין חשבון משתמש מקושר. באפשרותך לטפל בזה כמו ב־UI או ב־FAIL.