עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
meta=userinfo (ui)
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
קבלת מידע על המשתמש הנוכחי.
פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
- uiprop
אילו חלקי מידע לכלול:
- blockinfo
- מתייג אם המשתמש הנוכחי נחסם, על־ידי מי ומאיזו סיבה.
- hasmsg
- הוספת התג messages אם למשתמש הנוכחי יש הודעות ממתינות.
- groups
- רשימת כל הקבוצות שהמשתמש שייך אליהן.
- groupmemberships
- לרשום קבוצות שהמשתמש הנוכחי משויך אליהן במפורש, כולל תאריך תפוגה לחברות בכל קבוצה.
- implicitgroups
- רשימת כל הקבוצות שהמשתמש שייך אליהן באופן אוטומטי.
- rights
- רשימת כל ההרשאות שיש למשתמש הזה.
- changeablegroups
- רשימת הקבוצות שהמשתמש הנוכחי יכול להוסיף אליהן ולגרוע מהן.
- options
- רשימת כל ההעדפות שהמשתמש הנוכחי הגדיר.
- editcount
- הוספת מניין העריכות של המשתמש הנוכחי.
- ratelimits
- רשימת כל מגבלות הקצב שחלות על המשתמש הנוכחי.
- theoreticalratelimits
- מייצר רשימה של כל מכסות הקצב שיחולו על המשתמש הנוכחי אם אינו פטור מכל מכסות הקצב לפי הרשאות המשתמש או כתובת ה־IP
- הוספת כתובת הדוא"ל ותאריך אימות כתובת הדוא"ל.
- realname
- הוספת השם האמתי של המשתמש.
- acceptlang
- מדפיס את כותרת
Accept-Language
ששלח הלקוח בתסדיר מובנה. - registrationdate
- הוספת תאריך ההרשמה של המשתמש.
- unreadcount
- הוספת מניין הדפים שלא נקראו ברשימת המעקב של המשתמש (לכל היותר 999; מחזיר 1000+ אם יש יותר).
- centralids
- הוספת המזהה המרכזי ומצב השיוך למשתמש.
- latestcontrib
- הוספת התאריך של התרומה האחרונה של המשתמש.
- cancreateaccount
- מציין האם המשתמש רשאי ליצור חשבונות. כדי לבדוק האם ניתן ליצור חשבון מסוים, יש להשתמש ב־action=query&list=users&usprop=cancreate.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): acceptlang, blockinfo, cancreateaccount, centralids, changeablegroups, editcount, email, groupmemberships, groups, hasmsg, implicitgroups, latestcontrib, options, ratelimits, realname, registrationdate, rights, theoreticalratelimits, unreadcount
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- uiattachedwiki
עם uiprop=centralids, לציין האם המשתמש משויך לוויקי עם המזהה הזה.
דוגמאות:
- קבלת מידע על המשתמש הנוכחי.
- api.php?action=query&meta=userinfo [פתיחה בארגז חול]
- קבלת מידע נוסף על המשתמש הנוכחי.
- api.php?action=query&meta=userinfo&uiprop=blockinfo|groups|rights|hasmsg [פתיחה בארגז חול]