API:Informação da Imagem
| Está página faz parte da documentação da API de Ação do MediaWiki. |
| Versão MediaWiki: | ≥ 1.11 |
GET request to retrieve information about an image file or files.
This module can be used as a generator.
Documentação da 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}
Exemplo
Pedido GET
Get information about the file, File:Billy_Tipton.jpg
api.php?action=query&format=json&prop=imageinfo&titles=File:Billy_Tipton.jpg [teste na 'Área de Testes' da API (Sandbox)]
![[teste na 'Área de Testes' da API (Sandbox)]](https://en.wikipedia.org/wiki/Special:ApiSandbox#action=query&format=json&prop=imageinfo&titles=File:Billy_Tipton.jpg){kind=link}
Resposta
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"
}
]
}
}
}
}
Código de amostra
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 );
}
} );
Aplicação(ões) de demonstração
Erros possíveis
| Código | Informação |
|---|---|
| invalid-title | Título inválido no parâmetro iibadfilecontexttitle. |
| invalidurlparam | Valor inválido para iiurlparam (name=value). |
| urlparamnormal | Não foi possível normalizar os parâmetros de imagem para name. |
Histórico de parâmetros
- v1.23: Introduzido
canonicaltitle,commonmetadata,iiextmetadatalanguage,iiextmetadatamultilang,iiextmetadatafilter - v1.22: Introduzido
uploadwarning - v1.20: Introduzido
iilocalonly - v1.18: Introduzido
iimetadataversion,iiurlparam - v1.17: Introduzido
userid,parsedcomment,thumbmime,extmetadata - v1.16: Introduzido
dimensions - v1.15: Introduzido
iicontinue - v1.14: Introduzido
bitdepth - v1.13: Introduzido
mime,archivename - v1.12: Descontinuado
iihistory - v1.12: Introduzido
iilimit,iistart,iiend,iiurlwidth,iiurlheight
Notas adicionais
- 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.
Consulte também
- API:Fileinfo - to supersede this
propin future versions of the MediaWiki Action API - API:Stashimageinfo - retrieves information about stashed images
- API:Imagens - retrieves all images embedded on a page
- API:Informação - retrieves basic information about a list of pages
- API:Imageusage - finds all pages that use the given image or images
- API:Ficheiros Duplicados - finds any duplicates of the given file or files