API:सभी चित्र
यह पृष्ठ मीडियाविकि प्रतिक्रिया API प्रलेख का हिस्सा है। |
मीडियाविकि संस्करण: | ≥ 1.13 |
या तो शीर्षक या फिर समय के क्रम में सभी चित्र फ़ाइलों को सूचीबद्ध करने के लिए GET अनुरोध।
इस मोडल का इस्तेमाल सृष्टिकार के रूप में किया जा सकता है।
API प्रलेख
उदाहरण
उदाहरण 1: शीर्षक के आधार पर चित्र पाएँ
GET अनुरोध
Graffiti_000
से शुरू होने वाले सभी चित्रों से शुरू होकर नामस्थान में सभी चित्रों को सूचीबद्ध करें। शुरुआती जवाब को सिर्फ पहले तीन चित्रों तक सीमित करें।
जवाब
{
"batchcomplete": "",
"continue": {
"aicontinue": "Graffiti_BTER_0001.JPG",
"continue": "-||"
},
"query": {
"allimages": [
{
"name": "Graffiti_0001.JPG",
"timestamp": "2006-10-26T01:48:05Z",
"url": "https://upload.wikimedia.org/wikipedia/en/9/98/Graffiti_0001.JPG",
"descriptionurl": "https://en.wikipedia.org/wiki/File:Graffiti_0001.JPG",
"descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=7624737",
"ns": 6,
"title": "File:Graffiti 0001.JPG"
},
{
"name": "Graffiti_0002.JPG",
"timestamp": "2006-10-26T02:03:40Z",
"url": "https://upload.wikimedia.org/wikipedia/en/6/66/Graffiti_0002.JPG",
"descriptionurl": "https://en.wikipedia.org/wiki/File:Graffiti_0002.JPG",
"descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=7624935",
"ns": 6,
"title": "File:Graffiti 0002.JPG"
},
{
"name": "Graffiti_0003.JPG",
"timestamp": "2006-10-26T08:05:08Z",
"url": "https://upload.wikimedia.org/wikipedia/en/2/2b/Graffiti_0003.JPG",
"descriptionurl": "https://en.wikipedia.org/wiki/File:Graffiti_0003.JPG",
"descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=7628426",
"ns": 6,
"title": "File:Graffiti 0003.JPG"
}
]
}
}
उदाहरण कोड
Python
#!/usr/bin/python3
"""
get_allimages_by_name.py
MediaWiki API Demos
List all images in the namespace, starting from files that begin with
'Graffiti_000'. Limit the initial response to just the first three images.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"list": "allimages",
"aifrom": "Graffiti_000",
"ailimit": "3"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
IMAGES = DATA["query"]["allimages"]
for img in IMAGES:
print(img["title"])
PHP
<?php
/*
get_allimages_by_name.php
MediaWiki API Demos
List all images in the namespace, starting from files that begin with 'Graffiti_000'. Limit the initial response to just the first three images.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"list" => "allimages",
"aifrom" => "Graffiti_000",
"ailimit" => "3"
];
$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"]["allimages"] as $k => $v ) {
echo( $v["title"] . "\n" );
}
JavaScript
/*
get_allimages_by_name.js
MediaWiki API Demos
List all images in the namespace, starting from files that begin with 'Graffiti_000'. Limit the initial response to just the first three images.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
list: "allimages",
aifrom: "Graffiti_000",
ailimit: "3"
};
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 images = response.query.allimages;
for (var img in images) {
console.log(images[img].title);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_allimages_by_name.js
MediaWiki API Demos
List all images in the namespace, starting from files that begin with 'Graffiti_000'.
Limit the initial response to just the first three images.
MIT License
*/
var params = {
action: 'query',
format: 'json',
list: 'allimages',
aifrom: 'Graffiti_000',
ailimit: '3'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var images = data.query.allimages,
img;
for ( img in images ) {
console.log( images[ img ].title );
}
} );
उदाहरण 2: दिनांक के आधार पर चित्र पाएँ
GET अनुरोध
नामस्थान में 2010-01-01 18:05:46 (UTC) से शुरू होने वाले सभी चित्रों को सूचीबद्ध करें।
api.php? action=query& format=json& list=allimages& aisort=timestamp& aistart=2010-01-01T18:05:46Z [try in ApiSandbox]
जवाब
{
"batchcomplete": "",
"continue": {
"aicontinue": "20100101190633|Ryan_Baker_12-30-2009.JPG",
"continue": "-||"
},
"query": {
"allimages": [
{
"name": "DramaQueenThatGirl.jpg",
"timestamp": "2010-01-01T18:21:57Z",
"url": "https://upload.wikimedia.org/wikipedia/en/1/17/DramaQueenThatGirl.jpg",
"descriptionurl": "https://en.wikipedia.org/wiki/File:DramaQueenThatGirl.jpg",
"descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=25646192",
"ns": 6,
"title": "File:DramaQueenThatGirl.jpg"
},
{
"name": "VS_in_viena_austria.JPG",
"timestamp": "2010-01-01T18:42:49Z",
"url": "https://upload.wikimedia.org/wikipedia/en/b/bd/VS_in_viena_austria.JPG",
"descriptionurl": "https://en.wikipedia.org/wiki/File:VS_in_viena_austria.JPG",
"descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=25646382",
"ns": 6,
"title": "File:VS in viena austria.JPG"
},
{
"name": "Vasanthamtv_channel.jpg",
"timestamp": "2010-01-01T19:03:08Z",
"url": "https://upload.wikimedia.org/wikipedia/en/1/18/Vasanthamtv_channel.jpg",
"descriptionurl": "https://en.wikipedia.org/wiki/File:Vasanthamtv_channel.jpg",
"descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=25626466",
"ns": 6,
"title": "File:Vasanthamtv channel.jpg"
}
...
]
}
}
उदाहरण कोड
Python
#!/usr/bin/python3
"""
get_allimages_by_date.py
MediaWiki API Demos
List all images in the namespace, starting from January 1, 2010,
at 18:05:46 UTC.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"list": "allimages",
"aisort": "timestamp",
"aistart": "2010-01-01T18:05:46Z"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
IMAGES = DATA["query"]["allimages"]
for img in IMAGES:
print(img["title"])
PHP
<?php
/*
get_allimages_by_date.php
MediaWiki API Demos
List all images in the namespace, starting from January 1, 2010, at 18:05:46 UTC.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"list" => "allimages",
"aisort" => "timestamp",
"aistart" => "2010-01-01T18:05:46Z"
];
$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"]["allimages"] as $k => $v ) {
echo( $v["title"] . "\n" );
}
JavaScript
/*
get_allimages_by_date.js
MediaWiki API Demos
List all images in the namespace, starting from January 1, 2010, at 18:05:46 UTC.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
list: "allimages",
aisort: "timestamp",
aistart: "2010-01-01T18:05:46Z"
};
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 images = response.query.allimages;
for (var img in images) {
console.log(images[img].title);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_allimages_by_date.js
MediaWiki API Demos
List all images in the namespace, starting from January 1, 2010, at 18:05:46 UTC.
MIT License
*/
var params = {
action: 'query',
format: 'json',
list: 'allimages',
aisort: 'timestamp',
aistart: '2010-01-01T18:05:46Z'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var images = data.query.allimages,
img;
for ( img in images ) {
console.log( images[ img ].title );
}
} );
पैरमीटरों का इतिहास
- v1.23:
aiprop=canonicaltitle
,aiprop=commonmetadata
,aiprop=extmetadata
को जोड़ा गया - v1.20:
aisort
,aistart
,aiend
,aiuser
,aifilterbots
,aidir=newer
,aidir=older
को जोड़ा गया - v1.18:
aimime
,aiprop=mediatype
को जोड़ा गया - v1.17:
aiprop=userid
,aiprop=parsedcomment
को जोड़ा गया - v1.14:
bitdepth
को जोड़ा गया
अतिरिक्त टिप्पणियाँ
- हर चित्र के सिर्फ नवीनतम संस्करण को ही लौटाया जाता है।
aisort=timestamps
के लिए दिनांक को ठीक से प्रारूपित करने के लिए डेटा के प्रारूप देखें।
ये भी देखे
- API:Images - एक मिलता-जुलता मोडल, मगर यह एक
prop
है,list
नहीं; इन दोनों मोडलों के बीच के अंतर के बारे में अधिक जानकारी के लिए API:गुणधर्म और API:Lists देखें। - API:Imageinfo - चित्रों फ़ाइलों के बारे में विस्तृत जानकारी प्राप्त करता है।
- API:Stashimageinfo - स्टैश किए गए चित्रों के बारे में जानकारी प्राप्त करता है।
- API:Fileusage - निर्धारित चित्र या चित्रों का इस्तेमाल करने वाले सभी पृष्ठ ढूँढ़ें।
- API:Duplicatefiles - निर्धारित चित्र या चित्रों के नकल ढूँढ़ें।