СИЗНИЦА
Опростете и преведете съдържанието на 24 изходни езика.
Синхронната крайна точка приема изходен текст, изходен локал и един от двата режима. Той автоматично открива изходния език и връща готов за използване резултат на избрания изходен език.
{
"text": "Сложно изходно съдържание на избрания език.",
"locale": "bg",
"mode": "simple-language"
}Налични са примери за SDK и cURL
Крайна точка
POST /api/v2/translate
Създайте един резултат на обикновен или лесен език и го върнете в същия HTTP отговор.
Необходими заглавия
| Заглавие | Стойност | Целта |
|---|---|---|
| Authorization | Bearer <API_KEY> | Удостоверява проекта с текущата схема на HTTP носител |
| Content-Type | заявление/проект | Изявление на формата на заявлението |
| Accept | заявление/проект | Иска отговор на JSON |
| Idempotency-Key | Изисква се само за задания и партиди | Предпазва повтарящите се асинхронни подавания от създаване на дублирана работа |
Орган по искане
Никоя друга настройка на съдържанието не е част от схемата за публична заявка.
| Поле | Тип | Необходимо | Допускана стойност | Описание |
|---|---|---|---|---|
| text | въже | Да, да. | 1 до 10 000 Unicode знака | Съдържание на източника в избраната локалност |
| locale | въже | Да, да. | Един от 24 поддържани двубуквени кода | Изходен език. Изходният език се разпознава автоматично. |
| mode | въже | Да, да. | Лесно език, лесно език | Режим на опростяване |
{
"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-дневния кеш |
{
"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 открива автоматично изходния език и записва резултата в избрания изходен локал.