واجهة برمجة التطبيقات:البحث_عن_لغة

طلب GET يسمح بالبحث عن لغة محددة بأي نص كان باستخدام اسمها أو كود آيزو أو اسمها المحلي.

توثيق واجهة برمجة التطبيقات

action=languagesearch

(main | languagesearch)

• This module requires read rights.
• Source: Universal­Language­Selector
• 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]

مثال

طلب GET

api.php?action=languagesearch&search=gu [جربها في ApiSandbox]

النتيجة

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

عينة من الكود البرمجي

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

تطبيق أو تطبيقات توضيحية

• 

  لقطة من الشاشة لأداة اختيار اللغة العمومية التي تستخدم واجهة برمجة التطبيقات هذه

  مقدمة ويستخدمها في المقام الأول امتداد:أداة اختيار اللغة العمومية وتسمح للمستخدمين باختيار لغة وتكوين أعمال المساندة لها بطريقة سهلة.
• بوت ترجمة تلغرام يقبل مدخلات عن طريق رسائل الدردشة لاختيار اللغة. طالع الكود مستخدمًا واجهة برمجة التطبيقات.

الأخطاء المحتملة

الكود	معلومات
nosearch	يجب تعيين الوسيط search.

ملاحظات إضافية

• داخليًا، تتولى واجهة برمجة التطبيقات هذه تخزين قائمة طويلة للغاية من أسماء اللغات بلغات متعددة. المصدر الرئيسي لهذه القائمة هو مستودع البيانات المحلية المتاح للجميع إلى جانب بضع إضافات يدوية.

انظر أيضا

• واجهة برمجة التطبيقات:كافة وحدات البحث البرمجية