Получение списка поддерживаемых языков
Получение списка направлений перевода, поддерживаемых сервисом.
Краткое содержание:
JSON- и JSONP-интерфейсы
Ответ возвращается в формате JSON. Если задан параметр callback
, JSON-объект оборачивается в функцию с названием, указанном в этом параметре (JSONP).
Синтаксис запроса
https://translate.yandex.net/api/v1.5/tr.json/getLangs
? [key=<API-ключ>]
& [ui=<код языка>]
& [callback=<имя callback-функции>]
|
|
|
Обязательный параметр. В ответе список поддерживаемых языков будет перечислен в поле langs вместе с расшифровкой кодов языков. Названия языков будут выведены на языке, код которого соответствует этому параметру. Все коды языков перечислены в списке поддерживаемых языков. |
|
Имя функции обратного вызова. Используется для получения 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=<код языка>]
|
|
|
Обязательный параметр. В ответе список поддерживаемых языков будет перечислен в поле 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-ключ заблокирован |
Обязательный параметр.
В ответе список поддерживаемых языков будет перечислен в поле langs вместе с расшифровкой кодов языков. Названия языков будут выведены на языке, код которого соответствует этому параметру.
Все коды языков перечислены в списке поддерживаемых языков.
Имя функции обратного вызова. Используется для получения JSONP-ответа.