Получение списка поддерживаемых языков

Получение списка направлений перевода, поддерживаемых сервисом.

Краткое содержание:

JSON- и JSONP-интерфейсы

Ответ возвращается в формате JSON. Если задан параметр callback, JSON-объект оборачивается в функцию с названием, указанном в этом параметре (JSONP).

Синтаксис запроса

https://translate.yandex.net/api/v1.5/tr.json/getLangs
 ? [key=<API-ключ>]
 & [ui=<код языка>]
 & [callback=<имя callback-функции>]
key

API-ключ.

ui

Обязательный параметр.

В ответе список поддерживаемых языков будет перечислен в поле langs вместе с расшифровкой кодов языков. Названия языков будут выведены на языке, код которого соответствует этому параметру.

Все коды языков перечислены в списке поддерживаемых языков.

callbackИмя функции обратного вызова. Используется для получения JSONP-ответа.
key

API-ключ.

ui

Обязательный параметр.

В ответе список поддерживаемых языков будет перечислен в поле langs вместе с расшифровкой кодов языков. Названия языков будут выведены на языке, код которого соответствует этому параметру.

Все коды языков перечислены в списке поддерживаемых языков.

callbackИмя функции обратного вызова. Используется для получения JSONP-ответа.
Примечание. Все специальные символы должны быть экранированы.
Пример запроса
POST /api/v1.5/tr.json/getLangs?ui=en&key=API-KEY HTTP/1.1
Host: translate.yandex.net
Accept: */*
Content-Type: application/x-www-form-urlencoded
Пример ответа

Ответ возвращается в формате JSON.

Примечание. В связи с изменениями в работе сервиса поле dirs более не используется. Список поддерживаемых языков перечислен в поле langs.
С использованием параметра ui=ru 
{
    "dirs": [
        "ru-en",
        "ru-pl",
        "ru-hu",
        ...
    ],
   "langs": {
        "ru": "русский",
        "en": "английский",
        "pl": "польский",
        ...
    }
}
С использованием параметра ui=ru 
{
    "dirs": [
        "ru-en",
        "ru-pl",
        "ru-hu",
        ...
    ],
   "langs": {
        "ru": "русский",
        "en": "английский",
        "pl": "польский",
        ...
    }
}
Пример ошибки

Если выполнение запроса невозможно, возвращается сообщение об ошибке.

{"code":401,"message":"API key is invalid"}

{"code":401,"message":"API key is invalid"}

XML-интерфейс

Ответ возвращается в формате XML.

Синтаксис запроса

https://translate.yandex.net/api/v1.5/tr/getLangs
 ? [key=<API-ключ>]
 & [ui=<код языка>]
key

API-ключ.

ui

Обязательный параметр.

В ответе список поддерживаемых языков будет перечислен в поле langs вместе с расшифровкой кодов языков. Названия языков будут выведены на языке, код которого соответствует этому параметру.

Все коды языков перечислены в списке поддерживаемых языков.

key

API-ключ.

ui

Обязательный параметр.

В ответе список поддерживаемых языков будет перечислен в поле langs вместе с расшифровкой кодов языков. Названия языков будут выведены на языке, код которого соответствует этому параметру.

Все коды языков перечислены в списке поддерживаемых языков.

Примечание. Все специальные символы должны быть экранированы.
Пример запроса
POST /api/v1.5/tr/getLangs?ui=en&key=API-KEY HTTP/1.1
Host: translate.yandex.net
Accept: */*
Content-Type: application/x-www-form-urlencoded
Пример ответа

Ответ возвращается в формате XML.

Примечание. В связи с изменениями в работе сервиса поле dirs более не используется. Список поддерживаемых языков перечислен в поле langs.
С использованием параметра ui=ru 
<Langs>
    <dirs>
        <string>ru-en</string>
        <string>ru-pl</string>
        <string>ru-hu</string>
        ...
    </dirs>
    <langs>
        <Item key="ru" value="русский"/>
        <Item key="en" value="английский"/>
        <Item key="pl" value="польский"/>
    </langs>
</Langs>
С использованием параметра ui=ru 
<Langs>
    <dirs>
        <string>ru-en</string>
        <string>ru-pl</string>
        <string>ru-hu</string>
        ...
    </dirs>
    <langs>
        <Item key="ru" value="русский"/>
        <Item key="en" value="английский"/>
        <Item key="pl" value="польский"/>
    </langs>
</Langs>
Пример ошибки

Если выполнение запроса невозможно, возвращается сообщение об ошибке.

<Error code="401" message="API key is invalid"/>
 
<Error code="401" message="API key is invalid"/>

Коды ответов

Описание возможных кодов ответов. Код ответа возвращается только при неудачном выполнении запроса.

Значение Описание
401

Неправильный API-ключ
402

API-ключ заблокирован
Значение Описание
401

Неправильный API-ключ
402

API-ключ заблокирован