واجهة برمجة التطبيقات:Allusers
 | هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
| إصدار ميدياويكي: | ≥ 1.11 |
طلب GET الغرض منه سرد قائمة بالمستخدمين المسجلين، مرتبة حسب اسم المستخدم.
توثيق واجهة برمجة التطبيقات
list=allusers (au)
Enumerate all registered users. Specific parameters: Other general parameters are available.
Example:
|
مثال
طلب GET
طلب GET الغرض منه سرد قائمة بكافة المستخدمين، بدءا بهؤلاء التي تبدأ أسمائهم بمجموعة المحارف «Drov»
النتيجة
{
"batchcomplete": "",
"continue": {
"aufrom": "Drovark",
"continue": "-||"
},
"query": {
"allusers": [
{
"userid": 13239275,
"name": "Drov"
},
{
"userid": 7080866,
"name": "Drova"
},
{
"userid": 16013473,
"name": "Drova 82"
},
...
]
}
}
عينة من الكود البرمجي
Python
#!/usr/bin/python3
"""
get_allusers.py
MediaWiki API Demos
Demo of `Allusers` module: Get all users, starting from those whose name
begins with the string, 'Drov'.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"list": "allusers",
"auprefix": "Drov"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
USERS = DATA["query"]["allusers"]
for user in USERS:
print(user["name"])
PHP
<?php
/*
get_allusers.php
MediaWiki API Demos
Demo of `Allusers` module: Get all users, starting from those whose name begins with the string, 'Drov'.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"list" => "allusers",
"auprefix" => "Drov"
];
$url = $endPoint . "?" . http_build_query( $params );
$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$output = curl_exec( $ch );
curl_close( $ch );
$result = json_decode( $output, true );
foreach( $result["query"]["allusers"] as $k => $v ) {
echo( $v["name"] . "\n" );
}
JavaScript
/*
get_allusers.js
MediaWiki API Demos
Demo of `Allusers` module: Get all users, starting from those whose name begins with the string, 'Drov'.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
list: "allusers",
auprefix: "Drov"
};
url = url + "?origin=*";
Object.keys(params).forEach(function(key){url += "&" + key + "=" + params[key];});
fetch(url)
.then(function(response){return response.json();})
.then(function(response) {
var users = response.query.allusers;
for (var u in users) {
console.log(users[u].name);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_allusers.js
MediaWiki API Demos
Demo of `Allusers` module: Get all users, starting from those
whose name begins with the string, 'Drov'.
MIT License
*/
var params = {
action: 'query',
format: 'json',
list: 'allusers',
auprefix: 'Drov'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var users = data.query.allusers,
u;
for ( u in users ) {
console.log( users[ u ].name );
}
} );
الأخطاء المحتملة
| الكود | معلومات |
|---|---|
| augroup-excludegroup | لا يمكن استخدام group و excludegroup معا |
تاريخ المتغيرات
- v1.12: إضافة
auprop=registration
ملاحظات إضافية
- إن استدعاء واجهة برمجة التطبيقات هذه يستلزم مطابقة حالة الأحرف، حتى لا تكون نتيجة
aufrom=DROVهي ذات نتيجةaufrom=Drov. - تحفظ كافة أسماء المستخدمين المسجلين وتستدعى في صيغة أحرف كبيرة كاملة. لو كنت تستخدم
aufromأوauprefixفي استعلامك، تأكد من أنك تقدم لهم قيم تبدأ بمحارف كبيرة الحجم. - رغم أن السبيل المعتاد هو عرض أي مستخدم في قاعدة البيانات، يمكنك أيضا تقييد ردنا إلى مجرد هؤلاء المستخدمين الذين يتمتعون بعضوية مجموعة محددة، مثل إداري النظام أو البوتات. مجموعات المستخدمين هي الكيفية التي تتبعها ميدياويكي في منح المستخدمين حقوق وامتيازات معينة؛ طالع Help:User rights and groups لمزيد من التفاصيل عن كيفية عمل هذا النظام.
انظر أيضا
- واجهة برمجة التطبيقات:مستخدمون - يبحث عن معلومات عن قائمة من المستخدمين.