واجهة برمجة التطبيقات:معلومات_صورة
 | هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
| إصدار ميدياويكي: | ≥ 1.11 |
طلب GET للحصول على معلومات تتعلق بملف صورة أو ملفات صور.
يمكن استخدام هذه الوحدة البرمجية بصفة مولّد.
توثيق واجهة برمجة التطبيقات
![[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
![[جربها في 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.47: Introduced
thumburls(phab:T426246) - 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
ملاحظات إضافية
- سوف تظهر الملفات المرفوعة إلى ويكيميديا كومنز كما لو كانت مفقودة حينما تحاول الوصول إليها من مواقع ويكي MediaWiki أخرى.
- يشير الختم الزمني من هذه الوحدة البرمجية إلى آخر مرة جرى تعديل على الصورة.
- 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.
انظر أيضا
- API:Fileinfo - يحل محل
propفي الإصدارات القادمة من واجهة برمجة التطبيقات لتطبيق Action على ميدياويكي. - API:Stashimageinfo - جلب معلومات عن صور stashed
- واجهة برمجة التطبيقات:صور - جلب معلومات عن كافة الصور المدمجة في صفحة محددة
- واجهة برمجة التطبيقات:معلومات - جلب معلومات أساسية عن قائمة بالصفحات
- واجهة برمجة التطبيقات:Imageusage - البحث عن كافة الصفحات التي تستخدم الصورة المحددة أو الصور المعينة
- واجهة برمجة التطبيقات:Duplicatefiles - البحث عن أي مكررات من ملف محدد أو ملفات معينة