Для розробників

Ми надаємо доступ до 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
Казахська kk
Китайська zh
Корейська ko
Німецька de
Польска pl
Португальська pt
Російська ru
Турецька tr
Українська uk
Фарсі (Персидська) fa
Французька fr
Хінді hi
Японська ja

Відповідь

Відповідь являє собою JSON-об’єкт з такими властивостями:

Властивість Опис
result Містить об’єкт із результатом виконання операції чи null у випадку помилки
 
Властивість
Опис
translated Результат перекладу
language Результат визначення мови
politeness Автоматично визначена форма звертання (ввічлива чи неввічлива). Див. параметр politeness запиту.
error Містить об’єкт з описом помилки чи null у випадку успіху
 
Властивість Опис
code Код помилки
message Текст помилки

Приклад 1 (переклад eng->rus)

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
}