Определение языка

Определение языка, на котором написан заданный текст.

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

Ответ возвращается в виде кода языка. Определить название языка по его коду можно с помощью операции Получение списка поддерживаемых языков, задав при вызове параметр ui.

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

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

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

https://translate.yandex.net/api/v1.5/tr.json/detect
  ? [key=<API-ключ>]
  ? text=<текст>
  & [hint=<список вероятных языков текста>]
  & [callback=<имя callback-функции>]

key

API-ключ

text*

Текст, язык которого требуется определить.

Внимание

Для исходного текста обязательно используйте URL-кодирование.

hint

Список наиболее вероятных языков (им будет отдаваться предпочтение при определении языка текста). Разделитель списка — запятая.

callback

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

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

Примечание

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

Пример запроса
POST /api/v1.5/tr.json/detect?hint=en,de&key=API-KEY HTTP/1.1
Host: translate.yandex.net
Accept: */*
Content-Length: 17
Content-Type: application/x-www-form-urlencoded

text=Hello World!
Пример ответа
{
    "code": 200,
    "lang": "en"
}

XML-интерфейс

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

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

https://translate.yandex.net/api/v1.5/tr/detect
  ? [key=<API-ключ>]
  ? text=<текст>
  & [hint=<список вероятных языков текста>] 

key

API-ключ

text*

Текст, язык которого требуется определить.

Внимание

Для исходного текста обязательно используйте URL-кодирование.

hint

Список наиболее вероятных языков (им будет отдаваться предпочтение при определении языка текста). Разделитель списка — запятая.

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

Примечание

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

Пример запроса
POST /api/v1.5/tr/detect?hint=en,de&key=API-KEY HTTP/1.1
Host: translate.yandex.net
Accept: */*
Content-Length: 17
Content-Type: application/x-www-form-urlencoded

text=Hello World!
Пример ответа
HTTP/1.1 200 OK
Server: nginx
Content-Type: application/xml; charset=utf-8
Content-Length: 68
Connection: keep-alive
Keep-Alive: timeout=120
X-Content-Type-Options: nosniff
Date: Thu, 31 Mar 2016 10:50:20 GMT

<?xml version="1.0" encoding="utf-8"?>
<DetectedLang code="200" lang="en"/>

Коды ответов

Описание возможных кодов ответов.

Значение Описание
200 Операция выполнена успешно
401 Неправильный API-ключ
402 API-ключ заблокирован
404 Превышено суточное ограничение на объем переведенного текста