Reference na API
Zjednodušte a přeložte obsah do 24 výstupních jazyků.
Synchronní koncový bod přijímá zdrojový text, výstupní národní prostředí a jeden ze dvou režimů. Automaticky detekuje zdrojový jazyk a vrátí výsledek připravený k použití ve zvoleném výstupním jazyce.
{
"text": "Komplexní zdrojový obsah ve zvoleném jazyce.",
"locale": "cs",
"mode": "simple-language"
}Dostupné příklady SDK a cURL
Výsledný bod
POST /api/v2/translate
Vytvořte jeden výsledek v jazyce Plain Language nebo Easy Language a vraťte jej ve stejné odpovědi HTTP.
Požadované názevky
| Vzdělání | Hodnota | Účelem |
|---|---|---|
| Authorization | Bearer <API_KEY> | Ověří projekt s aktuálním schématem HTTP nosiče |
| Content-Type | žádost/json | Vyhlášení formátu žádosti |
| Accept | žádost/json | Požaduje odpověď JSON |
| Idempotency-Key | Vyžadováno pouze pro úlohy a dávky | Zabraňuje opakovaným asynchronním odesláním vytvářet duplicitní práci |
Žádostní orgán
Žádné další nastavení obsahu není součástí schématu veřejných požadavků.
| Polní | Typ | Požadavky | Dopuszovaná hodnota | Popis |
|---|---|---|---|---|
| text | řetěz | Ano, ano. | 1 až 10 000 znaků Unicode | Zdrojový obsah v vybraném lokálu |
| locale | řetěz | Ano, ano. | Jeden z 24 podporovaných dvoulitrových kódů | Výstupní jazyk. Zdrojový jazyk je detekován automaticky. |
| mode | řetěz | Ano, ano. | Jednoduchý jazyk, snadný jazyk | Přípravek zjednodušení |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Odpovědní orgán
Odpověď nesmí obsahovat vyřazená nastavení požadavku ani samostatné pole informací o kvalitě.
| Polní | Typ | Popis |
|---|---|---|
| requestId | řetěz | Jedinečný identifikátor pro podporu a záznamy |
| locale | řetěz | Vybrané výstupní národní prostředí |
| mode | řetěz | Vybraný režim zjednodušení |
| output | řetěz | Hotový výsledek ve vybraném výstupním národním prostředí |
| usage.inputCharacters | celá čísla | Znaky započítané pro tento požadavek nebo 0 pro přístup do mezipaměti |
| usage.cacheHit | booleovský | Zda výsledek pochází z 30denní mezipaměti |
{
"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
}
}Ověřovací chování
- chybějící text: odmítnutí s dokumentovanou chybou pole.
- Prázdný text: odmítněte s dokumentovanou chybou pole.
- Nepodporovaná lokalita: odmítněte; nikdy mlčky nenahradíte jinou lokalitu.
- Nepodporovaný režim: odmítněte; nikdy nevyberte režim automaticky.
- Neznámé odstavené pole: odmítnout s chybou zaměřenou na migraci nebo zvládnout pouze pomocí roviny kompatibility s výslovně upravenou verzi.
- Zdrojový text může používat jiný jazyk než národní prostředí. Simple8 automaticky detekuje zdrojový jazyk a zapíše výsledek do zvoleného výstupního národního prostředí.