واجهة برمجة التطبيقات:Alllinks
 | هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
| إصدار ميدياويكي: | ≥ 1.11 |
طلب GET الغرض منه سرد وصلات شبكية تنقلك إلى namespace محدد، مرتبة حسب العنوان.
يمكن استخدام هذه الوحدة البرمجية بصفة مولّد.
توثيق واجهة برمجة التطبيقات
مثال
بصفة افتراضية سوف يكون رد هذه الوحدة البرمجية مكررات لو كانت الصفحة تحتوي على عدة وصلات شبكية تنقلك إلى ذات نطاق الاسم.
يستخدم هذا المثال alunique=1 لإزالة أية عناوين مكررة في الرد.
طلب GET
سرد قائمة بالوصلات الشبكية المميزة (أي ليست مكررة) التي تنقلك إلى نطاق الاسم الرئيسي.
النتيجة
{
"batchcomplete": "",
"continue": {
"alcontinue": "!!!!Hashtagging",
"continue": "-||"
},
"query": {
"alllinks": [
{
"ns": 0,
"title": "!"
},
{
"ns": 0,
"title": "!!"
},
{
"ns": 0,
"title": "!!!"
},
...
}
عينة من الكود البرمجي
Python
#!/usr/bin/python3
"""
get_alllinks.py
MediaWiki API Demos
Demo of `Alllinks` module: List links pointing to the given namespace.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"list": "alllinks",
"alnamespace": "0",
"alunique": "1"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
LINKS = DATA["query"]["alllinks"]
for l in LINKS:
print(l["title"])
PHP
<?php
/*
get_alllinks.php
MediaWiki API Demos
Demo of `Alllinks` module: List links pointing to the given namespace.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"list" => "alllinks",
"alnamespace" => "0",
"alunique" => "1"
];
$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"]["alllinks"] as $k => $v ) {
echo( $v["title"] . "\n" );
}
JavaScript
/*
get_alllinks.js
MediaWiki API Demos
Demo of `Alllinks` module: List links pointing to the given namespace.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
list: "alllinks",
alnamespace: "0",
alunique: "1"
};
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 links = response.query.alllinks;
for (var l in links) {
console.log(links[l].title);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_alllinks.js
MediaWiki API Demos
Demo of `Alllinks` module: List links pointing to the given namespace.
MIT License
*/
var params = {
action: 'query',
format: 'json',
list: 'alllinks',
alnamespace: '0',
alunique: '1'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var links = data.query.alllinks,
l;
for ( l in links ) {
console.log( links[ l ].title );
}
} );
الأخطاء المحتملة
| الكود | معلومات |
|---|---|
| badcontinue | متابعة غير صحيحة; يجب عليك تمرير القيمة الأصلية التي تم إرجاعها بواسطة الاستعلام السابق. |
| invalidparammix | لا يمكن استخدام الوسيط alprop=ids مع alunique. يحدث هذا حينما تستخدم
alprop=ids و alunique معا. |
ملاحظات إضافية
- كما هو الحال مع وحدات الوصلات الشبكية البرمجية الأخرى داخل Action API، يكون رد هذه الوحدة البرمجية عناوين الصفحات التي تصل إلى نطاق الاسم، لا معرفات المصادر الموحدة تحديدا التي تصل إلى هذه الصفحات.
- يمكن استخدام هذه الوحدة البرمجية بصفة مولّد.
- سوف ترد الإصدارات السابقة خطأ لو حاول المستخدم تشغيل الوحدة البرمجية كموّلد، وكان
aluniqueمضبوطا ليكون صحيح «true». غيرنا هذا الأمر في الإصدار 1.24، كي نسمح باستخدام الوحدة البرمجية كمولّد حتى لو كانaluniqueمضبوطا ليكون صحيح «true».
انظر أيضا
- واجهة برمجة التطبيقات:وصلات_عكسية - يسرد قائمة بالوصلات الشبكية إلى صفحة محددة.
- API:Linkshere - مشابه للوحدة واجهة برمجة التطبيقات:وصلات_عكسية، يعرض وصلات شبكية إلى صفحة محددة. لاحظ أنه، وخلافا للوحدة واجهة برمجة التطبيقات:وصلات_عكسية، التي هي وحدة
listبرمجية، الوحدة API:Linkshere هي وحدةpropبرمجية. طالع الصفحات المعنية التي تتناول API:Properties و واجهة برمجة التطبيقات:قوائم لترى مدى اختلاف هاتين الوحدتين البرمجيتين. - API:Links - يسترد وصلات شبكية خاصة بصفحة محددة أو صفحات معينة.