Изпратете заявка за превод

Крайна точка за изпращане на заявка за превод

Тази крайна точка позволява изпращането на заявка за превод до системата Ovesio. Можете да изпратите множество текстове в една заявка, всеки със свои собствени ключове и контексти, като преводът може да бъде извършен едновременно на няколко езика.

URL адрес на крайната точка

 https://api.ovesio.com/v1/translate/request

Метод

 POST

Формат на данните

 application/json

Примерна JSON заявка

 {
  "from": "en",
  "to": ["fr", "de"],
  "conditions": {
    "de": "fr"
  },
  "use_existing_translation": true,
  "delta_mode": false,
  "workflow": 1,
  "callback_url": "https://example.com/api/callback",
  "data": [
    {
      "ref": "product-123",
      "content": [
        {
          "key": "title",
          "value": "Gaming Laptop ASUS ROG"
        },
        {
          "key": "description",
          "value": "High-performance laptop for gaming",
          "context": "Specificații produs"
        }
      ]
    }
  ]
}

Параметри на приложението

Параметър Тип Задължително Описание
from string да Изходен език. Ако не е известен, може да бъде пропуснат ( AUTO).
delta_mode Boolean не Включва callback само ако преводът е различен от предишния.
Workflow integer не Идентификаторът на желания работен процес.
use_existing_translation Boolean не Ако false, принуждава повторен превод, дори ако текстът вече съществува в системата.
to Array да Целеви езици (напр. ["fr", "de"]).
Conditions Object не Позволява дефинирането на междинни езици при верижни преводи (напр. {"de": "fr"}).
callback_url string не URL адресът, на който резултатите от превода ще бъдат изпратени чрез POST.
data Array да Текстове за превод.


Структура на полето data

ЗадължителноТипОписание на полето
ref string не Уникален идентификатор (напр. ID на продукт, елемент и т.н.).
content Array да Списък с текстове, всеки със собствен value и незадължителни key и context.


Структура на полето content

ЗадължителноТипОписание на полето
key string не Етикет на текст (напр. title, description и т.н.).
Value string да Действителният текст за превод.
context string не Семантичен контекст за превода (напр. „продуктова категория“).


Възможни отговори

Успешен отговор (HTTP 200)

 {
  "success": true,
  "data": [
    {
      "id": 320126,
      "ref": "product-123"
    }
  ]
}

Потвърждава, че заявката е приета и процесът на превод е започнал. Можете да използвате id, за да проверите състоянието по-късно.

Отговор за грешка (HTTP 400 или друг код ≠ 200)

 {
  "success": false,
  "errors": {
    "invalid_data": "Invalid format detected"
  }
}

Тази структура показва, че заявката е невалидна и полето errors ще съдържа конкретни подробности за възникналия проблем.

Примери за интеграция

Можете да разгледате примери за интеграция, достъпни на официалната GitHub страница на Ovesio.

Имате ли въпроси? Свържете се с нас

Резервирай демонстрационен разговор