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

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

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

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-ответа.

Примечание

Все специальные символы должны быть экранированы.

Пример запроса
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": "польский",
        ...
    }
} 
Пример ошибки

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

{"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 вместе с расшифровкой кодов языков. Названия языков будут выведены на языке, код которого соответствует этому параметру.

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

Примечание

Все специальные символы должны быть экранированы.

Пример запроса
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>
Пример ошибки

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

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

Коды ответов

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

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