API:Benutzer
Diese Seite ist Teil der Dokumentation der MediaWiki action API. |
MediaWiki Version: | ≥ 1.12 |
GET-Abfrage um Informationen über eine Liste von Benutzern abzurufen.
API-Dokumentation
Beispiel
GET-Anfrage
Erhält eine Liste über die angegebenen Benutzer -- jedes Objekt in der Liste enthält Informationen, die durch den Parameter
usprop
spezifiziert werdenapi.php? action=query& list=users& ususers=1.2.3.4|Catrope|Vandal01|Bob& usprop=blockinfo|groups|editcount|registration|emailable|gender [In der ApiSandbox ausprobieren]
Antwort
{
"batchcomplete": "",
"query": {
"users": [
{
"name": "1.2.3.4",
"invalid": ""
},
{
"userid": 4587601,
"name": "Catrope",
"editcount": 359,
"registration": "2007-06-07T16:36:03Z",
"groups": [
"*",
"user",
"autoconfirmed"
],
"emailable": "",
"gender": "male"
},
{
"name": "Vandal01",
"missing": ""
},
{
"userid": 2793024,
"name": "Bob",
"editcount": 4542,
"registration": "2006-11-18T21:55:03Z",
"groups": [
"extendedconfirmed",
"reviewer",
"*",
"user",
"autoconfirmed"
],
"emailable": "",
"gender": "male"
}
]
}
}
Beispielcode
Python
#!/usr/bin/python3
"""
get_users.py
MediaWiki API Demos
Demo of `Users` module: Get information about several users:
[[1.2.3.4]], [[Catrope]], [[Vandal01]], and [[Bob]]
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"list": "users",
"ususers": "Catrope|Bob",
"usprop": "blockinfo|groups|editcount|registration|emailable|gender"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
USERS = DATA["query"]["users"]
for u in USERS:
print(str(u["name"]) + " has " + str(u["editcount"]) + " edits.")
PHP
<?php
/*
get_users.php
MediaWiki API Demos
Demo of `Users` module: Get information about several users: [[1.2.3.4]], [[Catrope]], [[Vandal01]], and [[Bob]]
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"list" => "users",
"ususers" => "Catrope|Bob",
"usprop" => "blockinfo|groups|editcount|registration|emailable|gender",
"format" => "json"
];
$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"]["users"] as $user ){
echo( $user["name"] . " has " . $user["editcount"] . " edits." . "\n" );
}
JavaScript
/*
get_users.js
MediaWiki API Demos
Demo of `Users` module: Get information about several users: [[1.2.3.4]], [[Catrope]], [[Vandal01]], and [[Bob]]
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
list: "users",
ususers: "Catrope|Bob",
usprop: "blockinfo|groups|editcount|registration|emailable|gender",
format: "json"
};
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.users;
for (var u in users) {
console.log(users[u].name + " has " + users[u].editcount + " edits.");
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_users.js
MediaWiki API Demos
Demo of `Users` module: Get information about several users: [[1.2.3.4]], [[Catrope]], [[Vandal01]], and [[Bob]]
MIT License
*/
var params = {
action: 'query',
list: 'users',
ususers: 'Catrope|Bob',
usprop: 'blockinfo|groups|editcount|registration|emailable|gender',
format: 'json'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var users = data.query.users,
u;
for ( u in users ) {
console.log( users[ u ].name + " has " + users[ u ].editcount + " edits.");
}
} );
Parametergeschichte
- v1.29: Eingeführt
ususerids
,userrights
- v1.24: Veralteter
ustoken
- v1.18: Eingeführt
implicitgroups
- v1.17: Eingeführt
rights
- v1.16: Eingeführt
ususerids
,gender
- v1.14: Eingeführt
emailable
- v1.13: Eingeführt
registration
Siehe auch
- Help:Benutzerrechte und Benutzergruppen - Weitere Informationen zu Benutzerrechten und dazu, wie sie mit Gruppen zusammenhängen
- API:Benutzergruppen - Benutzer zu Gruppen hinzufügen und entfernen
- API:Alle Benutzer - Listet angemeldete Benutzer in alphabetischer Reihenfolge auf
- Extension:CentralAuth/API - Globale Benutzerinformationen