API:Query/fr

Le module  vous permet de récupérer l'information concernant un wiki et les données qu'il contient telles que le wikicode d'un page donnée, les liens et les catégories d'un ensemble de pages, ou le jeton dont vous avez besoin pour.

Modules du Query
Le module de requête possède trois types de sous-modules (appelés aussi modules de requête) :


 * Les concernant le wiki et l'utilisateur connecté.


 * les des pages, incluant les révisions des pages et le contenu.


 * Les des pages correspondant à certains critères.

Exemple 1 : spécifier des pages
A la différence des modules de requêtes des données meta et des listes, tous les modules de requête de propriété fonctionnent avec une liste de pages que l'on peut spécifier avec l'une des manières suivantes :


 * Par le nom, en utilisant le paramètre  ; par exemple.


 * Par l'ID de la page, en utilisant le paramètre  ; par exemple.


 * Par l'ID de révision, en utilisant le paramètre  ; par exemple  . La plupart des modules de requête convertissent l'ID de révision en ID de la page correspondante. Seul  utilise actuellement directement l'ID de révision.


 * En utilisant un générateur.

Exemple 2 : normalisation du titre
La normalisation des titres transforme le titre des page en leur forme canonique.

Cela veut dire qu'elle met en majuscule le premier caractère du titre, remplace les caractères souligné '_' par des espaces, et traduit le nom de l'espace de noms en sa forme locale, telle qu'elle a été définie pour ce wiki.

Exemple 3: titres absents et invalides
Les titres qui n'existent pas, ou qui ne sont pas valides, auront un attribut  ou   positionné dans la réponse.

Dans les formats de sortie qui prennent en charge des clés numériques de tableaux, les titres absents ou non valides auront des ID de page négatifs.

Exemple 4: requêtes continues
When all the data is not returned in the response of a query, there will be a  attribute to indicate that there is more data.

To get further data, add its values to the original request.

Exemple 5: fin de traitement par lot
The API returns a  element to indicate that all data for the current batch of items has been returned.

In the response of the sample query below,  has been included to indicate that all the data for each of the three images has been returned.

The next continuation will begin returning data for the next set of 3 images.

Exemple 6: les générateurs
Use generators if you want to get data about a set of pages.

For example, to get data about pages in a certain category, instead of querying  and then querying again with   set to all the returned pages, combine the two API calls into one by using.

When using a list module as a generator, you don't need to specify the pages.

However, for a property module, you should specify the pages which the generator will work on.

For example, to load all pages that are linked to from the main page, use.

Les paramètres passés à un générateur doivent être préfixés avec le caractère. Par exemple, lors de l'utilisation de, utilisez   au lieu de.

The sample query below gets links and categories for the first three pages in the main namespace starting with "Ba".

Historique des paramètres

 * v1.26:  ajouté
 * v1.9:  ajouté

Notes supplémentaires

 * Specifying titles through  or   is limited to 50 titles per query, or 500 for those with the   right.
 * Use multiple query modules together to get what you need in one request, e.g..
 * Generators only pass page titles to the query module and do not output any information themselves. Setting parameters like  will therefore have no effect.

Voir aussi

 * - Guide de démarrage rapide.
 * - Contient des informations sur l'utilisation du paramètre.