API:Alllinks
| Esta página es parte de la documentación de la API de acciones de MediaWiki. |
| Versión de MediaWiki: | ≥ 1.11 |
Solicitud GET para listar enlaces que apuntan a un namespace ordenado por título.
Este módulo puede ser utilizado como generador.
API Documentación
Ejemplo
Por defecto, este módulo devolverá duplicados si una página contiene múltiples enlaces apuntando al mismo espacio de nombres.
Este ejemplo usa alunique=1 para eliminar cualquier título duplicado en la respuesta.
Solicitud GET
Lista enlaces distintos (es decir, sin duplicados) que apuntan al espacio de nombres principal.
Respuesta
{
"batchcomplete": "",
"continue": {
"alcontinue": "!!!!Hashtagging",
"continue": "-||"
},
"query": {
"alllinks": [
{
"ns": 0,
"title": "!"
},
{
"ns": 0,
"title": "!!"
},
{
"ns": 0,
"title": "!!!"
},
...
}
Código de muestra
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 );
}
} );
Errores posibles
| Código | Información |
|---|---|
| badcontinue | Parámetro continue no válido. Debes pasar el valor original devuelto por la consulta anterior. |
| invalidparammix | El parámetro alprop=ids no se puede utilizar junto con alunique. Esto sucede cuando usas
alprop=ids y alunique juntos |
Notas adicionales
- Al igual que con otros módulos de enlace dentro de Action API, este módulo devuelve los títulos de las páginas que enlazan con el espacio de nombres, no los URIs exactos de esas páginas.
Este módulo puede ser utilizado como generador.
- Las versiones anteriores devolverían un error si el usuario intentara ejecutar este módulo como generador, y
aluniqueestablecido en verdadero. Esto se modificó en v1.24, para permitir el uso del módulo como generador, incluso sialuniquees cierto.
Véase también
- API:Backlinks - Las listas enlazan a una página dada.
- API:Linkshere - similar a API:Backlinks, obtiene enlaces a una página determinada. Ten en cuenta que, a diferencia de API:Backlinks, que es un módulo de
list, API:Linkshere es un módulo deprop. Mira las páginas respectivas en API:Propiedades y API:Listas para ver cómo difieren estos dos tipos de módulos. - API:Enlaces - Recupera enlaces a una página o páginas dada.