واجهة برمجة التطبيقات:وصلات_عكسية
 | هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
| إصدار ميدياويكي: | ≥ 1.9 |
طلب GET يسرد كافة الصفحات التي تصل شبكيًا إلى صفحة محددة.
توثيق واجهة برمجة التطبيقات
مثال
طلب GET
قائمة بالوصلات العكسية إلى صفحة الفلسفة.
النتيجة
{
"batchcomplete": "",
"continue": {
"blcontinue": "1|987",
"continue": "-||"
},
"query": {
"backlinks": [
{
"pageid": 12,
"ns": 0,
"title": "Anarchism"
},
{
"pageid": 128,
"ns": 1,
"title": "Talk:Atlas Shrugged"
},
{
"pageid": 336,
"ns": 0,
"title": "Altruism"
},
...
]
}
}
عينة من الكود البرمجي
Python
#!/usr/bin/python3
"""
get_backlinks.py
MediaWiki API Demos
Demo of `Backlinks` module: Get request to list pages which link to a certain page.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"list": "backlinks",
"bltitle": "philosophy"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
BACKLINKS = DATA["query"]["backlinks"]
for b in BACKLINKS:
print(b["title"])
PHP
<?php
/*
get_backlinks.php
MediaWiki API Demos
Demo of `Backlinks` module: Get request to list pages which link to a certain page.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"list" => "backlinks",
"bltitle" => "philosophy"
];
$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"]["backlinks"] as $k => $v ) {
echo( $v["title"] . "\n" );
}
JavaScript
/*
get_backlinks.js
MediaWiki API Demos
Demo of `Backlinks` module: Get request to list pages which link to a certain page.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
list: "backlinks",
bltitle: "philosophy"
};
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 backlinks = response.query.backlinks;
for (var b in backlinks) {
console.log(backlinks[b].title);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_backlinks.js
MediaWiki API Demos
Demo of `Backlinks` module: Get request to list pages which link to a certain page.
MIT License
*/
var params = {
action: 'query',
format: 'json',
list: 'backlinks',
bltitle: 'philosophy'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var backlinks = data.query.backlinks,
b;
for ( b in backlinks ) {
console.log( backlinks[ b ].title );
}
} );
حالات إعادة التوجيه
في المثال سالف الذكر، تظهر فقط الوصلات الشبكية المباشرة إلى صفحة الفلسفة لا غير.
حينما تضبط قيمة blredirect، سوف يتضمن الرد أي صفحات تصل عكسيًا إلى حالات إعادة توجيه للقيمة المحددة في bltitle.
تعامل الوصلات العكسية التي يعاد توجيهها هذه في صفة مجموعات مستقلة داخل ترتيب الرد وتكون في مستوى واحد تحت حالة إعادة التوجيه ذاتها.
ينطبق الحد الأقصى المحدد في bllimit على كل مستوى من مستويات الرد، لذا يكون رد bllimit=25 عدد يصل إلى 25 وصلة شبكية عكسية مباشرة، وعدد يصل إلى 25 وصلة شبكية عكسية داخل نطاق كل إعادة توجيه على حدة.
علاوة على ما سلف، سوف ينتج عن استخدام blcontinue حينما توجد إعادة توجيه في الرد المزيد من الوصلات الشبكية العكسية في المستوى الثاني، قبل الانتقال في النهاية إلى وصلات شبكية عكسية مباشرة أخرى، حال رد كافة الوصلات الشبكية العكسية لحالة إعادة توجيه واحدة كاملة.
الأخطاء المحتملة
| رمز | معلومات |
|---|---|
| blbadcontinue | متابعة غير صحيحة; يجب عليك تمرير القيمة الأصلية التي تم إرجاعها بواسطة الاستعلام السابق. |
انظر أيضا
- API:Linkshere - يبحث عن كافة الصفحات التي تصل شبكيًا إلى صفحة محددة. لاحظ أنه، وخلافا للوحدة API:Backlinks، التي هي وحدة
listبرمجية، الوحدة API:Linkshere هي وحدةpropبرمجية. طالع الصفحات المعنية التي تتناول API:Properties و واجهة برمجة التطبيقات:قوائم لترى مدى اختلاف هاتين الوحدتين البرمجيتين. - واجهة برمجة التطبيقات:مدمج_في - وحدة
propبرمجية تبحث عن كافة الصفحات التي تضمّن (أي تدمج معلومات من) الصفحة المحددة. - واجهة برمجة التطبيقات:Embeddedin - وحدة
listبرمجية تسرد الوصلات الشبكية العكسية الناتجة عن التضمين، تشبه Special:Whatlinkshere. - واجهة برمجة التطبيقات:Imageusage - يسرد الصفحات التي تستخدم الصورة المحددة أو الصور المعينة.
- واجهة برمجة التطبيقات:Fileusage - يسرد الصفحات التي تستخدم الملف المحدد أو الملفات المعينة.
- API:Globalusage - يسرد الصفحات الموجودة على مواقع ويكي أخرى تستخدم الملف أو الملفات المعطاة، يشبه Special:GlobalUsage.