Dokumentácia

Referencia na API

Zjednodušte a preložte obsah do 24 výstupných jazykov.

Synchrónny koncový bod akceptuje zdrojový text, miestne nastavenie výstupu a jeden z dvoch režimov. Automaticky rozpozná zdrojový jazyk a vráti výsledok pripravený na použitie vo vybranom výstupnom jazyku.

{
  "text": "Komplexný zdrojový obsah vo vybranom jazyku.",
  "locale": "sk",
  "mode": "simple-language"
}

K dispozícii sú príklady SDK a cURL

Koncový bod

POST /api/v2/translate

Vytvorte jeden výsledok vo formáte Plain Language alebo Easy Language a vráťte ho v rovnakej odpovedi HTTP.

Vyžadované nadpisy

VkladHodnotaÚčelom
AuthorizationBearer <API_KEY>Autentifikuje projekt s aktuálnou schémou HTTP nosiča
Content-Typežiadosť/jsonVyhlasuje formát žiadosti
Acceptžiadosť/jsonŽiada odpoveď JSON
Idempotency-KeyVyžaduje sa len pre úlohy a dávkyZabraňuje opakovaným asynchrónnym odoslaniam vytvárať duplicitné práce

Žiadosťný orgán

Žiadne iné nastavenie obsahu nie je súčasťou schémy verejných žiadostí.

PoľaTypVyžadovanéPovolená hodnotaOpis
textšnúrkyÁno, áno.1 až 10 000 znakov UnicodeZdrojový obsah v vybranom lokalite
localešnúrkyÁno, áno.Jeden z 24 podporovaných dvojlietkových kódovVýstupný jazyk. Zdrojový jazyk sa zistí automaticky.
modešnúrkyÁno, áno.Jednoduchý jazyk, ľahký jazykPríčin zjednodušenia
json
{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Odpoveďový orgán

Odpoveď nesmie obsahovať vyradené nastavenia požiadavky ani samostatné pole informácií o kvalite.

PoľaTypOpis
requestIdšnúrkyJedinečný identifikátor podpory a záznamov
localešnúrkyVybrané miestne nastavenie výstupu
modešnúrkyVybraný režim zjednodušenia
outputšnúrkyHotový výsledok vo vybratom miestnom nastavení výstupu
usage.inputCharacterscelkové čísloZnaky započítané pre túto požiadavku alebo 0 pre prístup do vyrovnávacej pamäte
usage.cacheHitboolovská hodnotaČi výsledok pochádza z 30-dňovej vyrovnávacej pamäte
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
  }
}

Správa o validácii

  • Chýbajúci text: odmietnuť s dokumentovanou chybou v poli.
  • Prázdny text: odmietnuť s dokumentovanou chybou poľa.
  • Nepodporovaná lokalita: odmietnuť; nikdy tichým spôsobom nenahradovať inú lokalitu.
  • Nepodporovaný režim: odmietnuť; nikdy automaticky nevyberte režim.
  • Neznané odchodové pole: odmietnuť s migráciou zameranou chybou alebo zvládnuť len prostredníctvom výslovne verzovaného vrstvy kompatibility.
  • Zdrojový text môže používať iný jazyk ako miestne nastavenie. Simple8 automaticky rozpozná zdrojový jazyk a zapíše výsledok do zvoleného výstupného miestneho nastavenia.