API:Backlinks
Bu sayfa MediaWiki Eylem API'si belgelerinin bir parçasıdır. |
MediaWiki sürümü: | ≥ 1.9 |
Belirli bir sayfaya bağlantı veren sayfaları listelemek için GET isteği.
API belgesi
Örnek
GET isteği
Yanıt
{
"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"
},
...
]
}
}
Örnek kod
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 );
}
} );
Yönlendirmeler
Yukarıdaki örnekte, yalnızca felsefe sayfasına doğrudan bağlantılar döndürülür.
blredirect
ayarlandığında, yanıt bltitle
içindeki değere yeniden yönlendirilen tüm sayfaları içerecektir.
Bu yeniden yönlendirilmiş geri bağlantılar, yanıt yönlendirmenin kendisinden bir seviye aşağıya yanıt hiyerarşisinde ayrı gruplar olarak ele alınır.
bllimit
olarak belirlenen limit, yanıtın her düzeyi için ayrı olarak uygulanır; bu nedenle, bllimit=25
, 25'e kadar doğrudan geri ve her bir bireysel yeniden yönlendirme içinde 25'e kadar geri döndürür.
Ek olarak, bir yönlendirme yanıttayken blcontinue
kullanılması, daha fazla doğrudan geri bağlantılara geçmeden önce, bir yeniden yönlendirme için tüm geri bağlantılar tam olarak geri alındıktan sonra, daha fazla ikinci seviye geri bağlantı döndürür.
Olası hatalar
Kod | Bilgi |
---|---|
blbadcontinue | Geçersiz devam parametresi. Önceki sorgu tarafından döndürülen orijinal değeri iletmeniz gerekir. |
Ayrıca bakınız
- API:Linkshere - Belirli bir sayfaya bağlantı veren tüm sayfaları bulur.
list
modülü olan API:Backlinks aksine, API:Linkshere birprop
modül olduğunu unutmayın. Bu iki tür modülün nasıl farklılaştığını görmek için API:Özellikler ve API:Listeler ile ilgili sayfalara bakın. - API:Transcludedin - verilen sayfaları yansıtma (diğer bir deyişle, bilgileri yerleştirerek) içeren tüm sayfaları bulan bir
prop
modüldür. - API:Embeddedin - Special:Whatlinkshere benzer şekilde, ekleme yoluyla geri bağlantıları listeleyen bir
list
modüldür. - API:Imageusage - verilen görüntüyü kullanan sayfaları listeler.
- API:Fileusage - Verilen dosyaları kullanan sayfaları listeler.
- API:Globalusage - lists pages on other wikis that use the given file(s), similar to Special:GlobalUsage.