Dokumentace

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
AuthorizationBearer <API_KEY>Ověří projekt s aktuálním schématem HTTP nosiče
Content-Typežádost/jsonVyhlášení formátu žádosti
Acceptžádost/jsonPožaduje odpověď JSON
Idempotency-KeyVyžadováno pouze pro úlohy a dávkyZabraň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íTypPožadavkyDopuszovaná hodnotaPopis
textřetězAno, ano.1 až 10 000 znaků UnicodeZdrojový obsah v vybraném lokálu
localeřetězAno, ano.Jeden z 24 podporovaných dvoulitrových kódůVýstupní jazyk. Zdrojový jazyk je detekován automaticky.
modeřetězAno, ano.Jednoduchý jazyk, snadný jazykPřípravek zjednodušení
json
{
  "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íTypPopis
requestIdřetězJedinečný identifikátor pro podporu a záznamy
localeřetězVybrané výstupní národní prostředí
modeřetězVybraný režim zjednodušení
outputřetězHotový výsledek ve vybraném výstupním národním prostředí
usage.inputCharacterscelá číslaZnaky započítané pro tento požadavek nebo 0 pro přístup do mezipaměti
usage.cacheHitbooleovskýZda výsledek pochází z 30denní mezipaměti
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
  }
}

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í.