API de MediaWiki/Allusers

De Wicri Outils
Révision datée du 2 décembre 2010 à 16:30 par imported>Jacques Ducloy (Résultats)

Le module allusers de l'API de MediaWiki permet d'obtenir une liste des contributeurs, triée par ordre alphabétique.

Exemple introductif

Ce module peut être utilisé à partir d'un navigateur en utilisant une url du type :

<url du wiki>/api.php?paramètres.

Exemple, pour ce wiki, dont l'url est : http://maquettewicri.loria.fr/ticri-outils/, l'accès normal est :

L'accès au module allusers utilise l'URL :

Paramètres

Les paramètres ont la forme identificateur = valeur, ils sont séparés par des caractères « & ».

  • Sélection de l'action liste des utilisateurs inscrits.
?action=query&list=allusers
  • aulimit : longueur maximale de la liste des résultats (valeur implicite 10).

Pour les autres options, voir :

Résultats

En principe la commande renvoie une liste structurée en xml.

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <allusers aufrom="Wicri robot" />
  </query-continue>
  <query>
    <allusers>
      <u name="Alice Hermann" />
      ...
      <u name="Thierry Daunois" />
    </allusers>
  </query>
</api>

En pratique, suivant le mode opératoire choisi on peut obtenir une version encapsulée dans une page html.

Par exemple, sous unix, la commande :

  curl "http://maquettewicri.loria.fr/ticri-outils/api.php5?action=query&list=allusers"

donne plutôt quelque chose comme :

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
	<title>MediaWiki API Result</title>
   ...
        <span style="color:blue;">&lt;u name=&quot;Alice Hermann&quot; /&gt;</span>