API:Sprachlinks

MediaWiki Version:

≥ 1.11

GET-Abfrage um eine Liste aller Sprachlinks von den angegebenen Seiten auf andere Sprachen zu erhalten.

API-Dokumentation

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]

Beispiel

GET-Abfrage

Erhält eine Liste von Sprachlinks, die eine angegebene Seite hat.

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

Antwort

{
    "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"
                    },
                    ...
                ]
            }
        }
    }
}

Beispielcode

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 );
} );

Mögliche Fehler

Code	Info
invalidparammix	Der Parameter title kann nur zusammen mit lang genutzt werden.

Parameterhistorie

• v1.23: llprop, url, langname, autonym, llinlanguagecode eingeführt
• v1.23: llurl veraltet
• v1.19: lldir eingeführt
• v1.18: lllang, lltitle eingeführt
• v1.17: llurl eingeführt
• v1.13: lllimit, llcontinue eingeführt

Siehe auch

• API:Links - Gibt alle Links von den angegebenen Seiten aus.
• API:Sprachrücklinks - Findet alle Seiten, die auf den angegebenen Sprachlink verlinken.