Документация

СИЗНИЦА

Опростете и преведете съдържанието на 24 изходни езика.

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

{
  "text": "Сложно изходно съдържание на избрания език.",
  "locale": "bg",
  "mode": "simple-language"
}

Налични са примери за SDK и cURL

Крайна точка

POST /api/v2/translate

Създайте един резултат на обикновен или лесен език и го върнете в същия HTTP отговор.

Необходими заглавия

ЗаглавиеСтойностЦелта
AuthorizationBearer <API_KEY>Удостоверява проекта с текущата схема на HTTP носител
Content-Typeзаявление/проектИзявление на формата на заявлението
Acceptзаявление/проектИска отговор на JSON
Idempotency-KeyИзисква се само за задания и партидиПредпазва повтарящите се асинхронни подавания от създаване на дублирана работа

Орган по искане

Никоя друга настройка на съдържанието не е част от схемата за публична заявка.

ПолеТипНеобходимоДопускана стойностОписание
textвъжеДа, да.1 до 10 000 Unicode знакаСъдържание на източника в избраната локалност
localeвъжеДа, да.Един от 24 поддържани двубуквени кодаИзходен език. Изходният език се разпознава автоматично.
modeвъжеДа, да.Лесно език, лесно езикРежим на опростяване
json
{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Отговорно тяло

Отговорът не трябва да съдържа оттеглени настройки на заявка или отделен масив с информация за качеството.

ПолеТипОписание
requestIdвъжеУникален идентификатор за поддръжка и регистри
localeвъжеИзбран изходен локал
modeвъжеИзбран режим на опростяване
outputвъжеЗавършен резултат в избрания изходен локал
usage.inputCharactersЦели бройПреброени знаци за тази заявка или 0 за попадение в кеша
usage.cacheHitбулевоДали резултатът идва от 30-дневния кеш
json
{
  "requestId": "req_sync_002",
  "locale": "en",
  "mode": "easy-language",
  "output": "You need to send documents.\nSend the documents before the deadline.",
  "usage": {
    "inputCharacters": 78,
    "cacheHit": false
  }
}

Поведение за валидиране

  • Липсващ текст: отхвърляне с документирана грешка на полето.
  • Празен текст: отхвърляне с документирана грешка на полето.
  • Неподдържана локация: отхвърляне; никога не заменяйте мълчаливо друга локация.
  • Неподдържан режим: отхвърляне; никога не избирайте режим автоматично.
  • Неизвестно пенсионирано поле: отхвърляне с грешка, фокусирана върху миграцията, или обработка само чрез изрично версиониран слой на съвместимост.
  • Изходният текст може да използва език, различен от локала. Simple8 открива автоматично изходния език и записва резултата в избрания изходен локал.