API:Alllinks/es
![]() | 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
![]() | La siguiente documentación es la salida de Special: |
list=alllinks (al)
- This module requires read rights.
- This module can be used as a generator.
- Source: MediaWiki
- License: GPL-2.0-or-later
Enumerate all links that point to a given namespace.
- alcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- alfrom
The title of the link to start enumerating from.
- alto
The title of the link to stop enumerating at.
- alprefix
Search for all linked titles that begin with this value.
- alunique
Only show distinct linked titles. Cannot be used with alprop=ids. When used as a generator, yields target pages instead of source pages.
- Type: boolean (details)
- alprop
Which pieces of information to include:
- ids
- Adds the page ID of the linking page (cannot be used with alunique).
- title
- Adds the title of the link.
- Values (separate with | or alternative): ids, title
- Default: title
- alnamespace
The namespace to enumerate.
- One of the following values: -1, -2, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 90, 91, 92, 93, 100, 101, 102, 103, 104, 105, 106, 107, 710, 711, 828, 829, 1198, 1199, 2600, 5500, 5501
- Default: 0
- allimit
How many total items to return.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- aldir
The direction in which to list.
- One of the following values: ascending, descending
- Default: ascending
- List linked titles, including missing ones, with page IDs they are from, starting at B.
- api.php?action=query&list=alllinks&alfrom=B&alprop=ids|title [open in sandbox]
- List unique linked titles.
- api.php?action=query&list=alllinks&alunique=&alfrom=B [open in sandbox]
- Gets all linked titles, marking the missing ones.
- api.php?action=query&generator=alllinks&galunique=&galfrom=B [open in sandbox]
- Gets pages containing the links.
- api.php?action=query&generator=alllinks&galfrom=B [open in sandbox]
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
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
alunique
establecido en verdadero. Esto se modificó en v1.24, para permitir el uso del módulo como generador, incluso sialunique
es 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.