Jump to content
MediaWiki

API:Categoryinfo/fr

From mediawiki.org
This page is a translated version of the page API:Categoryinfo and the translation is 100% complete.
Cette page fait partie de la documentation de l'API MediaWiki Action.
API MediaWiki Action
Fonctions de base
Authentification
Comptes et utilisateurs
Opérations sur les pages
Chercher
Outils pour les développeurs
Tutoriels
v · d · e
Version de MediaWiki :
≥ 1.13

Requête de type GET pour récupérer des informations à propos de quelques catégories.

Documentation de l'API

La documentation qui suit est le résultat de Special:ApiHelp/query+categoryinfo, généré automatiquement par la version pre-release de MediaWiki utilisée sur ce site (MediaWiki.org).

prop=categoryinfo (ci)

(main | query | categoryinfo)

Returns information about the given categories.

Specific parameter:
Other general parameters are available.
cicontinue

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.

Example:
Get information about Category:Foo and Category:Bar.
api.php?action=query&prop=categoryinfo&titles=Category:Foo|Category:Bar [open in sandbox]

Exemple

Requête GET

Obtenir des informations à propos de quelques catégories

Réponse

{
"batchcomplete":"",
"query":{
"pages":{
"-1":{
"ns":14,
"title":"Category:Foo",
"missing":"",
"categoryinfo":{
"size":1,
"pages":1,
"files":0,
"subcats":0
}
},
"1504":{
"pageid":1504,
"ns":0,
"title":"Albert"
},
"3108204":{
"pageid":3108204,
"ns":14,
"title":"Category:Infobox templates",
"categoryinfo":{
"size":2066,
"pages":2048,
"files":0,
"subcats":18
}
}
}
}
}

Exemple de code

Python

#!/usr/bin/python3
"""
 get_category_info.py
 MediaWiki API Demos
 Demo of `Categoryinfo` module: Get information about few categories
 MIT license
"""
importrequests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
 "action": "query",
 "format": "json",
 "titles": "Category:Foo|Category:Infobox templates",
 "prop": "categoryinfo"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
PAGES = DATA["query"]["pages"]
for k, v in PAGES.items():
 print(v["title"] + " has " + str(v["categoryinfo"]["pages"]) + " pages.")

PHP

<?php
//This file is autogenerated. See modules.json and autogenerator.py for details
/*
 get_category_info.php
 MediaWiki API Demos
 Demo of `Categoryinfo` module: Get information about a few categories
 MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
 "action" => "query",
 "format" => "json",
 "titles" => "Category:Foo|Category:Infobox templates",
 "prop" => "categoryinfo"
];
$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"]["pages"] as $k => $v ) {
 echo( $v["title"] . " has " . $v["categoryinfo"]["pages"] . " pages." . "\n" );
}

JavaScript

//This file is autogenerated. See modules.json and autogenerator.py for details
/*
 get_category_items.js
 MediaWiki API Demos
 Demo of `Categorymembers` module : List twenty items in a category
 MIT License
*/
varurl="https://en.wikipedia.org/w/api.php";
varparams={
action:"query",
prop:"categoryinfo",
titles:"Category:Foo|Category:Infobox templates",
format:"json"
};
url=url+"?origin=*";
Object.keys(params).forEach(function(key){url+="&"+key+"="+params[key];});
fetch(url)
.then(function(response){returnresponse.json();})
.then(function(response){
varpages=response.query.pages;
for(varpageinpages){
console.log(pages[page].title+" has "+pages[page].categoryinfo.pages+" pages.");
}
})
.catch(function(error){console.log(error);});

MediaWiki JS

// This file is autogenerated. See modules.json and autogenerator.py for details
/*
	get_category_info.js
	MediaWiki API Demos
	Demo of `Categoryinfo` module: Get information about a few categories
	MIT License
*/
varparams={
action:'query',
format:'json',
titles:'Category:Foo|Category:Infobox templates',
prop:'categoryinfo'
},
api=newmw.Api();
api.get(params).done(function(data){
varpages=data.query.pages,
page;
for(pageinpages){
console.log(pages[page].title+' has '+pages[page].categoryinfo.pages+' pages.');
}
});

Notes supplémentaires

  • Si la page de catégorie existe, mais que la catégorie ne contient aucun élément, un champ categoryinfo ne sera pas inclus dans la réponse de l'API.[demande de précisions ]
  • Quand davantage de résultats sont disponibles, utilisez le paramètre cicontinue pour continuer.

Voir aussi

AltStyle によって変換されたページ (->オリジナル) /