API:सभी श्रेणियाँ
 | यह पृष्ठ मीडियाविकि प्रतिक्रिया API प्रलेख का हिस्सा है। |
| मीडियाविकि संस्करण: | ≥ 1.12 |
निर्धारित मानदंडों में आने वाले सभी श्रेणियों को उनके शीर्षक के आधार पर सूचीबद्ध करने के लिए GET अनुरोध।
इस मोडल का इस्तेमाल सृष्टिकार के रूप में किया जा सकता है।
API प्रलेख
उदाहरण
GET अनुरोध
"15th-century caliphs" से शुरू होकर सभी श्रेणियों की सूची लाएँ।
api.php?
जवाब
{
{
"batchcomplete": "",
"continue": {
"accontinue": "15th-century_churches_in_Denmark",
"continue": "-||"
},
"query": {
"allcategories": [
{
"*": "15th-century caliphs"
},
{
"*": "15th-century calligraphers"
},
{
"*": "15th-century card games"
},
...
]
}
}
उदाहरण कोड
Python
#!/usr/bin/python3
"""
get_allcategories.py
MediaWiki API Demos
Demo of `Allcategories` module: Get all categories, starting from a
certain point, as ordered by category title.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"list": "allcategories",
"acfrom": "15th-century caliphs"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
CATEGORIES = DATA["query"]["allcategories"]
for cat in CATEGORIES:
print(cat["*"])
PHP
<?php
/*
get_allcategories.php
MediaWiki API Demos
Demo of `Allcategories` module: Get all categories, starting from a certian point, as ordered by category title.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"list" => "allcategories",
"acfrom" => "15th-century caliphs"
];
$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"]["allcategories"] as $k => $v ) {
echo( $v["*"] . "\n" );
}
JavaScript
/*
get_allcategories.js
MediaWiki API Demos
Demo of `Allcategories` module: Get all categories, starting from a certain point, as ordered by category title.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
list: "allcategories",
acfrom: "15th-century caliphs"
};
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 categories = response.query.allcategories;
for (var cat in categories) {
console.log(categories[cat]["*"]);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_allcategories.js
MediaWiki API Demos
Demo of `Allcategories` module: Get all categories,
starting from a certian point, as ordered by category title.
MIT License
*/
var params = {
action: 'query',
format: 'json',
list: 'allcategories',
acfrom: '15th-century caliphs'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var categories = data.query.allcategories,
cat;
for ( cat in categories ) {
console.log( categories[ cat ][ '*' ] );
}
} );
अतिरिक्त टिप्पणियाँ
- यह मोडल list=allpages&alnamespace=14 से अलग है क्योंकि बिना विवरण के श्रेणियों को सूचीबद्ध किया जाएगा, मगर उन अनुप्रेषणों तथा उन पृष्ठों को सूचीबद्ध नहीं किया जाएगा जहाँ कभी श्रेणी का इस्तेमाल नहीं किया गया था।
- जवाब में वे श्रेणियाँ हो सकते हैं जिन्हें पहले जोड़ा गया था फिर बाद में हटा दिया गया।
- क्योंकि जवाब में वे श्रेणियाँ भी हो सकते हैं जिन्हें हटाया दिया गया है या फिर खाली है, सूची को
acmin=1की मदद से छाँटने की सलाह दी जाती है, ताकि सिर्फ एक या एकाधिक सदस्यों वाले श्रेणियाँ ही सूचीबद्ध हो।
ये भी देखें
- API:Categorymembers - किसी श्रेणी के सदस्य पृष्ठों को सूचीबद्ध करें।
- API:Categories - एक
propमोडल जो किसी पृष्ठ से संबंधित सभी श्रेणियों को लाता है। - API:सभी पृष्ठ - एक और मोडल जो श्रेणी नामस्थान पर जा सकता है।