واجهة برمجة التطبيقات:معلومات
| هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
| إصدار ميدياويكي: | ≥ 1.8 |
طلب GET لعرض معلومات أساسية عن صفحة محددة أو صفحات معينة.
توثيق واجهة برمجة التطبيقات
مثال
طلب GET
الحصول على معلومات عن صفحة w:Albert Einstein، من بينها معرّف صفحة النقاش ومعرفات الموارد الموحدة المتعلقة بالصفحة
النتيجة
{
"batchcomplete": "",
"query": {
"pages": {
"736": {
"pageid": 736,
"ns": 0,
"title": "Albert Einstein",
"contentmodel": "wikitext",
"pagelanguage": "en",
"pagelanguagehtmlcode": "en",
"pagelanguagedir": "ltr",
"touched": "2018-12-13T11:58:27Z",
"lastrevid": 873382746,
"length": 154728,
"talkid": 21091085,
"fullurl": "https://en.wikipedia.org/wiki/Albert_Einstein",
"editurl": "https://en.wikipedia.org/w/index.php?title=Albert_Einstein&action=edit",
"canonicalurl": "https://en.wikipedia.org/wiki/Albert_Einstein"
}
}
}
}
عينة من الكود البرمجي
Python
#!/usr/bin/python3
"""
get_info.py
MediaWiki API Demos
Demo of `Info` module: Send a GET request to display information about a page.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"titles": "Albert Einstein",
"prop": "info",
"inprop": "url|talkid"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
PAGES = DATA["query"]["pages"]
for k, v in PAGES.items():
print(v["title"] + " has " + str(v["length"]) + " bytes.")
PHP
<?php
/*
get_info.php
MediaWiki API Demos
Demo of `Info` module: Send a GET request to display information about a page.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"titles" => "Albert Einstein",
"prop" => "info",
"inprop" => "url|talkid"
];
$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"] . " has " . $v["length"] . " bytes." . "\n" );
}
JavaScript
/*
get_info.js
MediaWiki API Demos
Demo of `Info` module: Send a GET request to display information about a page.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
titles: "Albert Einstein",
prop: "info",
inprop: "url|talkid"
};
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 + " has " + pages[p].length + " bytes.");
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_info.js
MediaWiki API Demos
Demo of `Info` module: Send a GET request to display information about a page.
MIT License
*/
var params = {
action: 'query',
format: 'json',
titles: 'Albert Einstein',
prop: 'info',
inprop: 'url|talkid'
},
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 + ' has ' + pages[ p ].length + ' bytes.' );
}
} );
تاريخ المتغيرات
- v1.41:
preloadمتقادم - v1.32:
readableمتقادم - v1.27: إضافة
visitingwatchers - v1.25: إضافة
intestactions - v1.24:
intokenمتقادم - v1.21: إضافة
watchers - v1.20: إضافة
notificationtimestamp - v1.17: إضافة
displaytitle - v1.16: إضافة
watched,preload - v1.14: إضافة
url,readable - v1.13: إضافة
talkid,subjectid - v1.11: إضافة
inprop,protection,intoken
ملاحظات إضافية
- الصفحات الموجودة في نطاق الاسم صفحة خاصة، مثل قائمة المراقبة، غير مدعومة.
- تغطي هذه الصفحة الوحدة البرمجية
list، التي تتناولinfo. يرجى الاطلاع على صفحة متغيرات ملف الفهرس لو كنت تبحث عن تفاصيل تخصaction=info.
انظر أيضا
- Action=info - وحدة برمجية مستقلة تستخدمها أداة معلومات الصفحة في برمجيات ميدياويكي؛ كم كبير من المعلومات التي تجلبها يشابه هذه الوحدة البرمجية.
- تعرض وحدة برمجة التطبيقات:Pageterms أية مصطلحات تستخدمها ويكي بيانات مثل labels أو descriptions، المتعلقة بصفحة محددة. طالع موقع ويكي بيانات لمزيد من المعلومات عن هذه الفئة الخاصة من المعلومات.
- واجهة برمجة التطبيقات:معلومات_صورة - عرض معلومات خاصة بملفات الصور على وجه التحديد
- API:Stashimageinfo - عرض معلومات عن ملفات صور stashed
- واجهة برمجية التطبيقات:معلومات_التصنيفات - عرض معلومات عن تصنيفات، مثل عدد الصفحات
- واجهة برمجة التطبيقات:مستخدمون - عرض معلومات عن قائمة بالمستخدمين، مثل عضويتهم في مجموعات أو عدد مرات التعديل
- واجهة برمجة التطبيقات:معلومات_المتغيرات - واجهة برمجة تطبيقات تتناول واجهات برمجة التطبيقات الأخرى، تعرض معلومات عن متغيرات واجهة برمجة التطبيقات