Для разработчиков

Мы предоставляем доступ к API для интеграции системы переводов в ваши проекты. Система автоматически улучшается при каждом последующем обращении. Стоимость использования API Multillect вычисляется на основе количества символов в запросе. Цена: $5 за 1000000 символов.

Перевод теста осуществляется путем отправки HTTP запроса на https://api.multillect.com/translate/json/1.0/<account-id>, где <account-id> — уникальный идентификатор учетной записи клиента.

Допустимые методы: GET и POST.
Тип ответа: JSON
Кодировка ответа: UTF-8

Параметры запроса:

Параметр Обязательный Описание
method да Должен быть translate/api/translate
from нет Исходный язык. Если параметр отсутствует, Multillect пытается автоматически определить исходный язык. Результат определения языка возвращается в поле "language" в ответе.
to да Результирующий язык
text да Текст для перевода в кодировке UTF-8 (длина текста должна быть не менее 2-х символов)
politeness нет Переключение вежливой/невежливой формы обращения. Например, ты/вы в русском языке.
   
Значение
 Описание
polite Вежливая
rude Невежливая
gender_from нет Пол говорящего
   
Значение Описание
male Мужской
female Женский
gender_to нет Пол человека, с которым ведется разговор (см. gender_from).
sig да Секретный ключ

Список поддерживаемых языков:

Язык Код
Арабский ar
Английский en
Испанский es
Китайский zh
Казахский kk
Корейский ko
Немецкий de
Польский pl
Португальский pt
Русский ru
Турецкий tr
Украинский uk
Фарси (Персидский) fa
Французский fr
Хинди hi
Японский ja

Ответ

Ответ представляет собой JSON-объект со следующими свойствами:

Свойство Описание
result Содержит объект с результатом выполнения операции или null в случае ошибки
 
Свойство
 Описание
translated Результат перевода
language Результат определения языка
politeness Автоматически определенная форма обращения (вежливая или невежливая). См. параметр politeness запроса.
error Содержит объект с описанием ошибки или null в случае успеха
 
Свойство Описание
code Код ошибки
message Текст ошибки

Пример 1 (перевод en->ru)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&from=en&to=ru&text=test&sig=38f4c080a05411e6a0328c89a5a1fd3

{
    "result": {
        "translated": "тест",
        "language": {
            "code": null
        }
    }
    "error": null,
    "timestamp": 1478019472,
    "id": null
}

Пример 2 (определение языка)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&to=ru&text=test&sig=38f4c080a05411e6a0328c89a5a1fd3

{
    "result": {
        "translated": "тест",
        "language": {
            "code": "en"
        }
    }
    "error": null,
    "timestamp": 1478019472,
    "id": null
}

Пример 3 (ошибочная ситуация)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&from=en&to=ru&text=&sig=38f4c080a05411e6a0328c89a5a1fd3

{
    "result": null,
    "error": {
        "code": 15,
        "message": "Too short text for translation"
    },
    "timestamp": 1478022138,
    "id": null
}

Пример 4 (определение формы обращения)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&from=ru&to=en&text=Вы%20великолепны&politeness=&sig=38f4c080a05411e6a0328c89a5a1fd3

{
  "result": {
    "translated": "You are magnificent",
    "language": {
      "code": "ru"
    },
    "politeness": "polite"
  },
  "error": null,
  "timestamp": 1478284482,
  "id": null
}