Wikimore

Cette page fait partie de la documentation de l'API MediaWiki Action.

requête GET pour chercher une langue dans un script suivant le nom, code ISO ou nom natif du langage

Documentation de l'API

La documentation qui suit est le résultat de Special:ApiHelp/languagesearch, généré automatiquement par la version pre-release de MediaWiki utilisée sur ce site (MediaWiki.org).

action=languagesearch

(main | languagesearch)

This module requires read rights.
Source: UniversalLanguageSelector
License: GPL-2.0-or-later OR MIT

Search for language names in any script.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Languagesearch

Specific parameters:

Other general parameters are available.

search: Search string.; This parameter is required.
typos: Number of spelling mistakes allowed in the search string.; Type: integer; Default: 1

Examples:

Search for "Te": api.php?action=languagesearch&search=Te [open in sandbox]
Search for "ഫി": api.php?action=languagesearch&search=ഫി [open in sandbox]
Search for "ഫി", allowing one typo: api.php?action=languagesearch&search=ഫി&typos=1 [open in sandbox]

Exemple

Requête GET

api.php?action=languagesearch&search=gu [Essayez !]

Réponse

{
    "languagesearch": {
        "gu": "gujarati",
        "gaa": "ga",
        "gn": "guarani",
        ...
    }
}

Exemple de code

Python

#!/usr/bin/python3

"""
    languagesearch.py

    MediaWiki API Demos
    Demo of `Languagesearch` module: Search for a language in any language

    MIT License
"""

import requests

S = requests.Session()

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

PARAMS = {
    "action": "languagesearch",
    "search": "Gu", #Could be name of the language, its iso code or native name
    "format": "json"
}

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

LANG = DATA['languagesearch']
for code, name in LANG.items():
    print(code + ": " + name)

PHP

<?php
/*
    languagesearch.php

    MediaWiki API Demos
    Demo of `Languagesearch` module: Search for a language in any language

    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "languagesearch",
    "search" => "Gu",
    "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["languagesearch"] as $langcode => $langname ) {
    echo( $langcode . ": " . $langname . "\n" );
}

JavaScript

/*
    languagesearch.js

    MediaWiki API Demos
    Demo of `Languagesearch` module: Search for a language in any language

    MIT License
*/

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

var params = {
    action: "languagesearch",
    search: "Gu",
    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 langs = response.languagesearch;
        for (var lang in langs) {
            console.log(lang + ": " + langs[lang] );
        }
    })
    .catch(function(error){console.log(error);});

MediaWiki JS

/*
	languagesearch.js

	MediaWiki API Demos
	Demo of `Languagesearch` module: Search for a language in any language

	MIT License
*/

var params = {
		action: 'languagesearch',
		search: 'Gu',
		format: 'json'
	},
	api = new mw.Api();

api.get( params ).done( function ( data ) {
	var langs = data.languagesearch,
		lang;
	for ( lang in langs ) {
		console.log( lang + ': ' + langs[ lang ] );
	}
} );

Applications de démonstration

Capture d'écran de l'outil Sélecteur Universel de Langage, qui utilise cette API
Provided and primarily used by the Extension:UniversalLanguageSelector that allows users to select a language and configure its support in an easy way.
Telegram translation bot that accepts input via chat message for language selection. See the code using the API.

Erreurs possibles


Code	Information
nosearch	Le paramètre `search` doit être défini.

Notes supplémentaires

Internally, this API stores a very long list of language names in many different languages. The major source for this list is Common Locale Data Repository along with a few manual additions.

Voir aussi

API:All search modules

Category:MediaWiki API query lists/fr