API:Querypage

Versión de MediaWiki:

≥ 1.18

Solicitud GET para obtener una lista proporcionada por una página especial basada en QueryPage.

API Documentación

list=querypage (qp)

(main | query | querypage)

• This module requires read rights.
• This module can be used as a generator.
• Source: MediaWiki
• License: GPL-2.0-or-later

Get a list provided by a QueryPage-based special page.

• https://www.mediawiki.org/wiki/Special:MyLanguage/API:Querypage

Specific parameters:

Other general parameters are available.

qppage

The name of the special page. Note, this is case-sensitive.

This parameter is required.

One of the following values: Ancientpages, BrokenRedirects, Deadendpages, DisambiguationPageLinks, DisambiguationPages, DoubleRedirects, Fewestrevisions, GadgetUsage, GloballyWantedFiles, ListDuplicatedFiles, Listredirects, Lonelypages, Longpages, MediaStatistics, MostGloballyLinkedFiles, Mostcategories, Mostimages, Mostinterwikis, Mostlinked, Mostlinkedcategories, Mostlinkedtemplates, Mostrevisions, OrphanedTimedText, Shortpages, Uncategorizedcategories, Uncategorizedimages, Uncategorizedpages, Uncategorizedtemplates, UnconnectedPages, Unusedcategories, Unusedimages, Unusedtemplates, Unwatchedpages, Wantedcategories, Wantedfiles, Wantedpages, Wantedtemplates, Withoutinterwiki

qpoffset

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.

Type: integer

Default: 0

qplimit

Number of results to return.

Type: integer or max

The value must be between 1 and 500.

Default: 10

Example:

Return results from Special:Ancientpages.

api.php?action=query&list=querypage&qppage=Ancientpages [open in sandbox]

Ejemplo

Solicitud GET

En la consulta a continuación, llamamos a la API para obtener una lista de las primeras diez páginas que no están categorizadas

api.php?action=query&format=json&list=querypage&qppage=Uncategorizedpages&qplimit=10 [Prueba en ApiSandbox]

Respuesta

{
  "batchcomplete": "", 
  "continue": {
    "continue": "-||", 
    "qpoffset": 10
  }, 
  "query": {
    "querypage": {
      "cached": "", 
      "cachedtimestamp": "2019-02-22T11:46:48Z", 
      "maxresults": 5000, 
      "name": "Uncategorizedpages", 
      "results": [
        {
          "ns": 0, 
          "title": "Abelardo Delgado", 
          "value": "0"
        }, 
        {
          "ns": 0, 
          "title": "Agriculture in Tonga", 
          "value": "0"
        }, 
        {
          "ns": 0, 
          "title": "Andriandramaka", 
          "value": "0"
        }
        ...
      ]
    }
  }
}

Código de muestra

Python

#!/usr/bin/python3

"""
    get_querypage_list.py

    MediaWiki API Demos
    Demo of `Querypage` module: List first 10 pages which are uncategorized

    MIT License
"""

import requests

S = requests.Session()

URL = "https://en.wikipedia.org/w/api.php"

PARAMS = {
    "qplimit": "10",
    "action": "query",
    "qppage": "Uncategorizedpages",
    "list": "querypage",
    "format": "json"
}

R = S.get(url=URL, params=PARAMS)
DATA = R.json()

QUERYPAGE = DATA['query']['querypage']['results']

for p in QUERYPAGE:
    print(str(p['title']))

PHP

<?php
/*
    get_querypage_list.php

    MediaWiki API Demos
    Demo of `Querypage` module: List first 10 pages which are uncategorized

    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "query",
    "list" => "querypage",
    "qppage" => "Uncategorizedpages",
    "qplimit" => "10",
    "format" => "json"
];

$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"]["querypage"]["results"] as $page ){
    echo( $page["title"] . "\n" );
}

JavaScript

/*
    get_querypage_list.js

    MediaWiki API Demos
    Demo of `Querypage` module: List first 10 pages which are uncategorized

    MIT License
*/

var url = "https://en.wikipedia.org/w/api.php"; 

var params = {
    action: "query",
    list: "querypage",
    qppage: "Uncategorizedpages",
    qplimit: "10",
    format: "json"
};

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 querypage = response.query.querypage.results;
        for (var p in querypage) {
            console.log(querypage[p].title);
        }
    })
    .catch(function(error){console.log(error);});

MediaWiki JS

/*
	get_querypage_list.js

	MediaWiki API Demos
	Demo of `Querypage` module: List first 10 pages which are uncategorized

	MIT License
*/

var params = {
		action: 'query',
		list: 'querypage',
		qppage: 'Uncategorizedpages',
		qplimit: '10',
		format: 'json'
	},
	api = new mw.Api();

api.get( params ).done( function ( data ) {
	var querypage = data.query.querypage.results,
		p;
	for ( p in querypage ) {
		console.log( querypage[ p ].title );
	}
} );

Valores de página especial

(MediaWiki 1.32.0)

Ancientpages	Listredirects	Mostlinked	Unusedtemplates
BrokenRedirects	Lonelypages	Mostrevisions	Unwatchedpages
Deadendpages	Longpages	Shortpages	Wantedcategories
DisambiguationPageLinks	MediaStatistics	Uncategorizedcategories	Wantedfiles
DisambiguationPages	Mostcategories	Uncategorizedpages	Wantedpages
DoubleRedirects	MostGloballyLinkedFiles	Uncategorizedimages	Wantedtemplates
EntityUsage	Mostimages	Uncategorizedtemplates	Withoutinterwiki
Fewestrevisions	Mostinterwikis	UnconnectedPages
GloballyWantedFiles	Mostlinkedcategories	Unusedcategories
ListDuplicatedFiles	Mostlinkedtemplates	Unusedimages

Errores posibles

Código	Info
unknown_qppage	Valor no reconocido para el parámetro qppage: value.
noqppage	Se debe establecer el parámetro qppage.

Notas adicionales

Este módulo puede ser utilizado como generator . El filtrado del espacio de nombres no está disponible en estas páginas. La forma posible es filtrar manualmente "ns" desde resultados recopilados.

Véase también

• API:Allpages - Lista todas las páginas que cumplen ciertos criterios, dentro de un determinado Espacio de nombres .
• API:Categorymembers - Lista todas las páginas dentro de una categoría
• API:Pageswithprop - Lista todas las páginas que utilizan una propiedad de página dada.