API:Imageinfo
| 本页是MediaWiki Action API帮助文档的一部份。 |
| MediaWiki版本： | ≥ 1.11 |
GET 请求检索有关一个或多个图像文件的信息。
该模块可用作生成器。
API帮助文档
![[open in sandbox]](/wiki/Special:ApiSandbox#action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo){kind=link}
![[open in sandbox]](/wiki/Special:ApiSandbox#action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp%7Cuser%7Curl){kind=link}
示例
GET请求
获取有关文件“File:Billy_Tipton.jpg”的信息
![[在Api沙盒中尝试]](https://en.wikipedia.org/wiki/Special:ApiSandbox#action=query&format=json&prop=imageinfo&titles=File:Billy_Tipton.jpg){kind=link}
回应
Request URL:
{
"batchcomplete": "",
"query": {
"normalized": [
{
"from": "File:Billy_Tipton.jpg",
"to": "File:Billy Tipton.jpg"
}
],
"pages": {
"36266497": {
"pageid": 36266497,
"ns": 6,
"title": "File:Billy Tipton.jpg",
"imagerepository": "local",
"imageinfo": [
{
"timestamp": "2012-06-27T21:16:21Z",
"user": "Gobonobo"
}
]
}
}
}
}
示例代码
Python
#This file is auto-generated. See modules.json and autogenerator.py for details
#!/usr/bin/python3
"""
get_imageinfo.py
MediaWiki API Demos
Demo of `Imageinfo` module: Get information about an image file.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"prop": "imageinfo",
"titles": "File:Billy_Tipton.jpg"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
PAGES = DATA["query"]["pages"]
for k, v in PAGES.items():
print(v["title"] + " is uploaded by User:" + v["imageinfo"][0]["user"])
PHP
<?php
//This file is autogenerated. See modules.json and autogenerator.py for details
/*
get_imageinfo.php
MediaWiki API Demos
Demo of `Imageinfo` module: Get information about an image file.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"prop" => "imageinfo",
"titles" => "File:Billy Tipton.jpg"
];
$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"] . " is uploaded by User:" . $v["imageinfo"][0]["user"] . "\n" );
}
JavaScript
//This file is autogenerated. See modules.json and autogenerator.py for details
/*
get_imageinfo.js
MediaWiki API Demos
Demo of `Imageinfo` module: Get information about an image file.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
prop: "imageinfo",
titles: "File:Billy Tipton.jpg"
};
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 pages = response.query.pages;
for (var p in pages) {
console.log(pages[p].title + " is uploaded by User:" + pages[p].imageinfo[0].user);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
// This file is autogenerated. See modules.json and autogenerator.py for details
/*
get_imageinfo.js
MediaWiki API Demos
Demo of `Imageinfo` module: Get information about an image file.
MIT License
*/
var params = {
action: 'query',
format: 'json',
prop: 'imageinfo',
titles: 'File:Billy Tipton.jpg'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var pages = data.query.pages,
p;
for ( p in pages ) {
console.log( pages[ p ].title + ' is uploaded by User:' + pages[ p ].imageinfo[ 0 ].user );
}
} );
Demo app(s)
可能的错误
| 代码 | 信息 |
|---|---|
| invalid-title | iibadfilecontexttitle参数中的标题无效。 |
| invalidurlparam | iiurlparam的值无效（name=value）。 |
| urlparamnormal | 不能为name标准化图片参数。 |
参数历史
- v1.23: 启用
canonicaltitle,commonmetadata,iiextmetadatalanguage,iiextmetadatamultilang,iiextmetadatafilter - v1.22: 启用
uploadwarning - v1.20: 启用
iilocalonly - v1.18: 启用
iimetadataversion,iiurlparam - v1.17: 启用
userid,parsedcomment,thumbmime,extmetadata - v1.16: 启用
dimensions - v1.15: 启用
iicontinue - v1.14: 启用
bitdepth - v1.13: 启用
mime,archivename - v1.12: 弃用
iihistory - v1.12: 启用
iilimit,iistart,iiend,iiurlwidth,iiurlheight
补充资料
- Files uploaded to the Wikimedia Commons will appear to be missing when accessed from other MediaWiki wikis.
- The timestamp from this module indicates the last time the image was modified.
- Since T360589, it is no longer guaranteed that the thumbnail URL returned by the API matches the requested thumbnail width (
iiurlwidth). The thumbnail, which will be fetched from a pregenerated list, is either of the same width or larger. This is not issue when the browser can do the resizing, but if you do require the exact size, you now need to access the appropriate thumbnail URL directly.
参见
- API:Fileinfo - to supersede this
propin future versions of the MediaWiki Action API - API:存储图片信息 - retrieves information about stashed images
- API:Images - retrieves all images embedded on a page
- API:Info - retrieves basic information about a list of pages
- API:Imageusage - finds all pages that use the given image or images
- API:Duplicatefiles - finds any duplicates of the given file or files