API:Allusers
Esta página es parte de la documentación de la API de acciones de MediaWiki. |
Versión de MediaWiki: | ≥ 1.11 |
Solicitud GET para enumerar todos los usuarios registrados según lo ordenado, por nombre de usuario.
Documentación de la API
Ejemplo
Solicitud GET
Solicitud GET para listar todos los usuarios, comenzando por aquellos cuyo nombre comienza con la cadena, "Drov"
Respuesta
{
"batchcomplete": "",
"continue": {
"aufrom": "Drovark",
"continue": "-||"
},
"query": {
"allusers": [
{
"userid": 13239275,
"name": "Drov"
},
{
"userid": 7080866,
"name": "Drova"
},
{
"userid": 16013473,
"name": "Drova 82"
},
...
]
}
}
= Código de ejemplo
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 );
}
} );
Posibles errores
Código | Información |
---|---|
augroup-excludegroup | group y excludegroup no se pueden usar juntos |
Historial de parámetros
- v1.12: Introducido
auprop=registration
Documentos adicionales
- Esta llamada a la API distingue entre mayúsculas y minúsculas, por lo que
aufrom=DROV
no devuelve los mismos resultados queaufrom=Drov
. - Todos los nombres de usuario registrados se guardan y se recuperan en mayúscula. Si estás utilizando
aufrom
oauprefix
en tu consulta, asegúrate de pasarles valores que comiencen con un carácter en mayúscula. - Aunque el comportamiento predeterminado es listar a cualquier usuario en la base de datos, también podemos limitar nuestra respuesta solo a aquellos usuarios que pertenecen a un determinado grupo, como sysops o bots. Los grupos de usuarios son cómo MediaWiki otorgan a los usuarios ciertos derechos y privilegios; ver Ayuda:Permisos y grupos de usuario para más detalles sobre cómo funciona este sistema.
Véase también
- API:Usuarios - Encuentra información sobre una lista de usuarios.