واجهة برمجة التطبيقات:Alltransclusions
 | هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
| إصدار ميدياويكي: | ≥ 1.21 |
طلب GET يسرد كافة حالات التضمين القائمة وغير القائمة.
يمكن استخدام هذه الوحدة البرمجية بصفة مولّد.
توثيق واجهة برمجة التطبيقات
مثال
طلب GET
الحصول على ثلاث صفحات فريدة في نطاق الاسم الرئيسي الذي يحتوي على حالات التضمين.
api.php?
النتيجة
{
"batchcomplete": "",
"continue": {
"atcontinue": "!Hero_(album)",
"continue": "-||"
},
"query": {
"alltransclusions": [
{
"ns": 0,
"title": "!!Destroy-Oh-Boy!!"
},
{
"ns": 0,
"title": "!Action Pact!"
},
{
"ns": 0,
"title": "!Arriba!"
}
]
}
}
عينة من الكود البرمجي
Python
#!/usr/bin/python3
"""
get_alltransclusions.py
MediaWiki API Demos
Demo of `Alltransclusions` module: Get three unique pages in the main
namespace which contain transclusions.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"list": "alltransclusions",
"atunique": "1",
"atnamespace": "0",
"atlimit": "3"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
TRANSCLUSIONS = DATA["query"]["alltransclusions"]
for t in TRANSCLUSIONS:
print(t["title"])
PHP
<?php
/*
get_alltransclusions.php
MediaWiki API Demos
Demo of `Alltransclusions` module: Get three unique pages in the main namespace which contain transclusions.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"list" => "alltransclusions",
"atunique" => "1",
"atnamespace" => "0",
"atlimit" => "3"
];
$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"]["alltransclusions"] as $k => $v ) {
echo( $v["title"] . "\n" );
}
JavaScript
/*
get_alltransclusions.js
MediaWiki API Demos
Demo of `Alltransclusions` module: Get three unique pages in the main namespace which contain transclusions.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
list: "alltransclusions",
atunique: "1",
atnamespace: "0",
atlimit: "3"
};
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 transclusions = response.query.alltransclusions;
for (var t in transclusions) {
console.log(transclusions[t].title);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_alltransclusions.js
MediaWiki API Demos
Demo of `Alltransclusions` module: Get three unique pages
in the main namespace which contain transclusions.
MIT License
*/
var params = {
action: 'query',
format: 'json',
list: 'alltransclusions',
atunique: '1',
atnamespace: '0',
atlimit: '3'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var transclusions = data.query.alltransclusions,
t;
for ( t in transclusions ) {
console.log( transclusions[ t ].title );
}
} );
الأخطاء المحتملة
| الكود | معلومات |
|---|---|
| unknown_atnamespace | قيمة غير معروفة للوسيط atnamespace: value.
Results from enumerating a non-existent namespace. |
ملاحظات إضافية
- هذه الوحدة البرمجية جزء من واجهة برمجة التطبيقات:Alllinks.
انظر أيضا
- واجهة برمجة التطبيقات:قوالب – ينتج عنه قائمة بكافة الصفحات المضمنة في صفحة محددة.