واجهة برمجة التطبيقات:Allfileusages
هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
إصدار ميدياويكي: | ≥ 1.22 |
طلب GET الغرض منه سرد كافة حالات استخدام الملف، يشمل ذلك حالات الاستخدام غير الموجودة.
توثيق واجهة برمجة التطبيقات
مثال
طلب GET
سرد أول عشرة ملفات مستخدمة تبدأ بالكلمة «Icon» وما هي معرفات الصفحات التي تستخدم الملفات عليها
النتيجة
{
"batchcomplete": "",
"continue": {
"afcontinue": "Icon-C4004.jpg|7174658",
"continue": "-||"
},
"query": {
"allfileusages": [
{
"fromid": 12221220,
"ns": 6,
"title": "File:Icon"
},
{
"fromid": 12274856,
"ns": 6,
"title": "File:Icon"
},
{
"fromid": 14729339,
"ns": 6,
"title": "File:Icon"
}
...
]
}
}
عينة من الكود البرمجي
Python
#!/usr/bin/python3
"""
get_allfileusages.py
MediaWiki API Demos
Demo of `allfileusage` module: List all file usages, including non-existing
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"afprefix": "Icon",
"list": "allfileusages",
"afprop": "ids|title",
"format": "json"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
USAGES = DATA["query"]["allfileusages"]
for img in USAGES:
print(img["title"])
PHP
<?php
/*
get_allfileusages.php
MediaWiki API Demos
Demo of `allfileusage` module: List all file usages, including non-existing.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"list" => "allfileusages",
"afprefix" => "Icon",
"afprop" => "ids|title"
];
$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"]["allfileusages"] as $k => $v ) {
echo( $v["title"] . "\n" );
}
JavaScript
/*
get_allfileusages.js
MediaWiki API Demos
Demo of `allfileusage` module: List all file usages, including non-existing.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
list: "allfileusages",
afprefix: "Icon",
afprop: "ids|title"
};
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 usages = response.query.allfileusages;
for (var img in usages) {
console.log(usages[img].title);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_allfileusages.js
MediaWiki API Demos
Demo of `allfileusage` module: List all file usages, including non-existing.
MIT License
*/
var params = {
action: 'query',
format: 'json',
list: 'allfileusages',
afprefix: 'Icon',
afprop: 'ids|title'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var usages = data.query.allfileusages,
img;
for ( img in usages ) {
console.log( usages[ img ].title );
}
} );
انظر أيضا
- API:Properties - الحصول على خصائص صفحة معينة.
- واجهة برمجة التطبيقات:قوائم - سرد قائمة ينطبق عليها معيار معين.