API:Jazykové odkazy

Verze MediaWiki:

≥ 1.11

Požadavek GET pro získání seznamu všech jazykových odkazů z poskytnutých stránek do jiných jazyků.

Dokumentace API

prop=langlinks (ll)

(main | query | langlinks)

• This module requires read rights.
• Source: MediaWiki
• License: GPL-2.0-or-later

Returns all interlanguage links from the given pages.

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

Specific parameters:

Other general parameters are available.

llprop

Which additional properties to get for each interlanguage link:

url

Adds the full URL.

langname

Adds the localised language name (best effort). Use llinlanguagecode to control the language.

autonym

Adds the native language name.

Values (separate with | or alternative): autonym, langname, url

lllang

Only return language links with this language code.

lltitle

Link to search for. Must be used with lllang.

lldir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

llinlanguagecode

Language code for localised language names.

Default: en

lllimit

How many langlinks to return.

Type: integer or max

The value must be between 1 and 500.

Default: 10

llcontinue

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

llurl

Deprecated.

Whether to get the full URL (cannot be used with llprop).

Type: boolean (details)

Example:

Get interlanguage links from the page MediaWiki.

api.php?action=query&prop=langlinks&titles=MediaWiki&redirects= [open in sandbox]

Příklad

Dotazování přes GET

Získejte seznam jazykových odkazů, které daná stránka obsahuje.

api.php?action=query&titles=Albert%20Einstein&prop=langlinks&format=json [zkuste v ApiSandbox]

Odpověď

{
    "continue": {
        "llcontinue": "736|ay",
        "continue": "||"
    },
    "query": {
        "pages": {
            "736": {
                "pageid": 736,
                "ns": 0,
                "title": "Albert Einstein",
                "langlinks": [
                    {
                        "lang": "ab",
                        "*": "\u0410\u043b\u0431\u0435\u0440\u0442 \u0415\u0438\u043d\u0448\u0442\u0435\u0438\u043d"
                    },
                    {
                        "lang": "af",
                        "*": "Albert Einstein"
                    },
                    {
                        "lang": "als",
                        "*": "Albert Einstein"
                    },
                    ...
                ]
            }
        }
    }
}

Ukázkový kód

Python

#!/usr/bin/python3

"""
    langlinks.py
    MediaWiki API Demos
    Demo of `Langlinks` module: Get a list of language links that a given page has
    MIT License
"""

import requests

S = requests.Session()

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

PARAMS = {
    "action": "query",
    "titles": "Albert Einstein",
    "prop": "langlinks",
    "format": "json"
}

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

print(DATA)

PHP

<?php

/*
    langlinks.php
    MediaWiki API Demos
    Demo of `Langlinks` module: Get a list of language links that a given page has
    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "query",
    "titles" => "Albert Einstein",
    "prop" => "langlinks",
    "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 );
var_dump( $result );

JavaScript

/*
    langlinks.js
    MediaWiki API Demos
    Demo of `Langlinks` module: Get a list of language links that a given page has
    MIT License
*/

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

var params = {
    action: "query",
    titles: "Albert Einstein",
    prop: "langlinks",
    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) {console.log(response);})
    .catch(function(error){console.log(error);});

MediaWiki JS

/*
	langlinks.js
	MediaWiki API Demos
	Demo of `Langlinks` module: Get a list of language links that a given page has
	MIT License
*/

var params = {
		action: 'query',
		titles: 'Albert Einstein',
		prop: 'langlinks',
		format: 'json'
	},
	api = new mw.Api();

api.get( params ).done( function ( data ) {
	console.log( data );
} );

Možné chyby

Code	Info
invalidparammix	Parametr title lze použít pouze s lang.

Historie parametrů

• v1.23: Představeno llprop, url, langname, autonym, llinlanguagecode
• v1.23: Zastaralé llurl
• v1.19: Představeno lldir
• v1.18: Představeno lllang, lltitle
• v1.17: Představeno llurl
• v1.13: Představeno lllimit, llcontinue

Související odkazy

• API:Odkazy - vrátí všechny odkazy z daných stránek.
• API:Langbacklinks - Najde všechny stránky, které odkazují na daný jazykový odkaz.