API:Zufällig
Appearance
Diese Seite ist Teil der Dokumentation der MediaWiki action API. |
MediaWiki Version: | ≥ 1.12 |
GET-Abfrage um eine Liste zufälliger Seiten zu betrachten.
Dieses Modul kann als Generator benutzt werden.
API-Dokumentation
Beispiel
GET-Anfrage
Listet 5 zufällige Seiten auf
Antwort
{
"batchcomplete": "",
"continue": {
"rncontinue": "0.559881820010|0.559881954661|47659388|0",
"continue": "-||"
},
"query": {
"random": [
{
"id": 32381675,
"ns": 0,
"title": "Mallabhum Institute of Technology"
},
{
"id": 25126452,
"ns": 3,
"title": "User talk:96.232.132.176"
},
{
"id": 1440028,
"ns": 0,
"title": "Hyundai Epsilon engine"
},
{
"id": 35446805,
"ns": 15,
"title": "Category talk:Ukrainian card games"
},
{
"id": 12613,
"ns": 0,
"title": "Grue"
}
]
}
}
Beispielcode
Python
#!/usr/bin/python3
"""
get_random.py
MediaWiki API Demos
Demo of `Random` module: Get request to list 5 random pages.
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
"action": "query",
"format": "json",
"list": "random",
"rnlimit": "5"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
RANDOMS = DATA["query"]["random"]
for r in RANDOMS:
print(r["title"])
PHP
<?php
/*
get_random.php
MediaWiki API Demos
Demo of `Random` module: Get request to list 5 random pages.
MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"format" => "json",
"list" => "random",
"rnlimit" => "5"
];
$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"]["random"] as $k => $v ) {
echo( $v["title"] . "\n" );
}
JavaScript
/*
get_random.js
MediaWiki API Demos
Demo of `Random` module: Get request to list 5 random pages.
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = {
action: "query",
format: "json",
list: "random",
rnlimit: "5"
};
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 randoms = response.query.random;
for (var r in randoms) {
console.log(randoms[r].title);
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
get_random.js
MediaWiki API Demos
Demo of `Random` module: Get request to list 5 random pages.
MIT License
*/
var params = {
action: 'query',
format: 'json',
list: 'random',
rnlimit: '5'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
var randoms = data.query.random,
r;
for ( r in randoms ) {
console.log( randoms[ r ].title );
}
} );
Parametergeschichte
- v1.26: Das vorherige Limit von 10/20 für
rnlimit
wurde auf das standardmäßige Limit 500/5000 erhöht. - v1.26:
rnredirect
veraltet - v1.26:
rnfilterredir
eingeführt - v1.14:
rnredirect
eingeführt
Zusätzliche Anmerkungen
- Im Gegensatz zu den meisten anderen Modulen der Action API wird standardmäßig 1 Seite ausgegeben, nicht 10.
- Seiten werden in einer festgelegten Sequenz ausgegeben; nur der Startpunkt ist wirklich zufällig.
- Das standardmäßige Verhalten ist, Seiten aus dem gesamten Wiki auszuwählen, darunter Diskussionsseiten, Benutzerseiten und so weiter. Wenn du nach einer ähnlichen Funktion wie Special:Random suchst, d.h. einen zufälligen Artikel erhalten möchtest, begrenze
rnnamespace
auf0
. - Wenn die Seitenanzahl kleiner als
rnlimit
ist, wird die Abfrage einfach alle verfügbaren Seiten ausgeben. Sie wird keine Seiten wiederholen, um die Antwort auf das Limit zu erhöhen.
Siehe auch
- Manual:Random page - beschreibt, wie man die API im Backend konfiguriert.