API за ясен език и лесен за четене текст.
Изпратете вашия изходен текст, желания целеви език и един от двата езикови режима. Simple8 автоматично открива изходния език и връща готовия текст на целевия език.
{
"text": "Сложно изходно съдържание на избрания език.",
"locale": "bg",
"mode": "simple-language"
}Налични са примери за SDK и cURL
Крайна точка
POST /api/v2/translate
Създава обикновен текст или текст на обикновен език и го връща директно в HTTP отговора.
Необходими заглавия
| Заглавие | Стойност | Целта |
|---|---|---|
| Authorization | Bearer <API_KEY> | Удостоверяване на работното пространство |
| Content-Type | заявление/проект | Увежда се, че заявката съдържа JSON |
| Accept | заявление/проект | Иска отговор на JSON |
| Idempotency-Key | Изисква се само за основни и колективни поръчки | Предотвратява двойни възгледни поръчки |
Орган по искане
Никоя друга настройка на съдържанието не е част от схемата за публична заявка.
| Поле | Тип | Необходимо | Допускана стойност | Описание |
|---|---|---|---|---|
| text | въже | Да, да. | От 1 до 5 000 Unicode кодови точки, нормализирани по NFC | Изходна текст |
| locale | въже | Да, да. | Един от 136 поддържани дву- или трибуквени кода | Изходен език. Изходният език се разпознава автоматично. |
| mode | въже | Да, да. | simple-language, easy-language | Режим на опростяване |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Отговорно тяло
Отговорът съдържа готовия текст и документираните данни за използването.
| Поле | Тип | Описание |
|---|---|---|
| requestId | въже | Уникален идентификатор за поддръжка и регистри |
| locale | въже | Избран целеви език |
| mode | въже | Избран режим на опростяване |
| output | въже | Завършен текст на избрания целеви език |
| usage.inputCharacters | Цели брой | Преброени знаци за тази заявка или 0 за попадение в кеша |
| usage.cacheHit | булево | Дали резултатът идва от 180-дневния кеш |
{
"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
}
}Поведение за валидиране
- Липсващи, празни, непознати или невалидни полета връщат HTTP 400 с код за грешка invalid_request и подробности за проверката.
- Дължината на текста се измерва след NFC нормализация в Unicode кодови точки.
- Локалът трябва да бъде един от 136-те документирани дву- или трибуквени кода.
- Режимът трябва да бъде точно simple-language или easy-language.
- Изходният текст може да бъде написан на език, различен от посочения. Simple8 автоматично открива езика и създава резултата на избрания целеви език.