API:Random
Deze pagina maakt deel uit van de MediaWiki Action API documentatie. |
MediaWiki-versie: | ≥ 1.12 |
GET request om een lijst willekeurige pagina's te bekijken.
Deze module kan worden gebruikt als een generator .
API documentatie
list=random (rn)
Get a set of random pages. Pages are listed in a fixed sequence, only the starting point is random. This means that if, for example, Main Page is the first random page in the list, List of fictional monkeys will always be second, List of people on stamps of Vanuatu third, etc. Specific parameters: Other general parameters are available.
Examples:
|
Voorbeeld
GET request
Lijst met 5 willekeurige pagina's
Antwoord
{
"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"
}
]
}
}
Voorbeeldcode
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 );
}
} );
Parameter geschiedenis
- v1.26: Vorige limiet van %1 op
rnlimit
is uitgebreid naar standaard 500/5000 limieten. - v1.26: Verouderd
rnredirect
- v1.26: Geïntroduceerd
rnfilterredir
- v1.14: Geïntroduceerd
rnredirect
Meer informatie
- Anders dan de meeste modules in de Action API , is het standaardaantal teruggegeven pagina's 1, niet 10.
- Pagina's worden in een vaste volgorde teruggegeven, alleen het beginpunt is willekeurig.
- Het standaardgedrag is om pagina's uit de hele wiki te kiezen, inclusief overlegpagina's, gebruikerspagina's, enzovoort. Als u naar een vergelijkbare functionaliteit zoekt als met Special:Random, dus willekeurige artikelen, beperk
rnnamespace
tot0
. - Als het aantal pagina's minder dan
rnlimit
is, worden eenvoudig alle beschikbare pagina's teruggegeven. Er worden geen pagina's herhaald om tot de gestelde limiet te komen.
Zie ook
- Manual:Random page - beschrijft hoe u de API op de backend kunt instellen.