API:Alle Benutzer
Diese Seite ist Teil der Dokumentation der MediaWiki action API. |
MediaWiki Version: | ≥ 1.11 |
GET-Abfrage um alle registrierten Benutzer sortiert nach ihrem Benutzernamen aufzulisten.
API-Dokumentation
Beispiel
GET-Anfrage
GET-Abfrage um alle Benutzer aufzulisten, beginnend mit denen, deren Benutzername mit der Zeichenkette "Drov" beginnt.
Antwort
{
"batchcomplete": "",
"continue": {
"aufrom": "Drovark",
"continue": "-||"
},
"query": {
"allusers": [
{
"userid": 13239275,
"name": "Drov"
},
{
"userid": 7080866,
"name": "Drova"
},
{
"userid": 16013473,
"name": "Drova 82"
},
...
]
}
}
Beispielcode
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 );
}
} );
Mögliche Fehler
Code | Information |
---|---|
augroup-excludegroup | group und excludegroup können nicht zusammen genutzt werden |
Parametergeschichte
- v1.12: Eingeführt
auprop=registration
Zusätzliche Anmerkungen
- Diese API-Abfrage berücksichtigt Groß-/Kleinschreibung, sodass
aufrom=DROV
nicht die gleichen Ergebnisse wieaufrom=Drov
ausgibt. - Alle Benutzernamen werden gespeichert und großgeschrieben erhalten. Wenn du in deiner Abfrage
aufrom
oderauprefix
nutzt, stelle sicher, dass du sie mit Werten übergibst, die mit einem Großbuchstaben beginnen. - Obwohl standardmäßig alle Benutzer aus der Datenbank aufgelistet werden, können wir die Antwort auch auf die Benutzer einschränken, die zu einer bestimmten Gruppe, wie Administratoren oder Bots, gehören. In MediaWiki werden Benutzern bestimmte Rechte und Privilegien durch Benutzergruppen gewährt; siehe Help:Benutzerrechte und Benutzergruppen für weitere Details dazu, wie dieses System funktioniert.
Siehe auch
- API:Benutzer - findet Informationen über eine Liste von Benutzern.