API:Imageinfo/ru
| Эта страница является частью документации по API действий MediaWiki. |
| Версия 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|user|url){kind=link}
Пример
GET-запрос
Получить информацию о файле File:Billy_Tipton.jpg
api.php?action=query&format=json&prop=imageinfo&titles=File:Billy_Tipton.jpg [попробуйте в ApiSandbox]
![[попробуйте в ApiSandbox]](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 );
}
} );
Демо-приложение(я)
Возможные ошибки
| Код | Информация |
|---|---|
| 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:Stashimageinfo - 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