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
| Vklad | Hodnota | Účelom |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentifikuje projekt s aktuálnou schémou HTTP nosiča |
| Content-Type | žiadosť/json | Vyhlasuje formát žiadosti |
| Accept | žiadosť/json | Žiada odpoveď JSON |
| Idempotency-Key | Vyžaduje sa len pre úlohy a dávky | Zabraň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ľa | Typ | Vyžadované | Povolená hodnota | Opis |
|---|---|---|---|---|
| text | šnúrky | Áno, áno. | 1 až 10 000 znakov Unicode | Zdrojový obsah v vybranom lokalite |
| locale | šnúrky | Áno, áno. | Jeden z 24 podporovaných dvojlietkových kódov | Výstupný jazyk. Zdrojový jazyk sa zistí automaticky. |
| mode | šnúrky | Áno, áno. | Jednoduchý jazyk, ľahký jazyk | Príčin zjednodušenia |
{
"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ľa | Typ | Opis |
|---|---|---|
| requestId | šnúrky | Jedinečný identifikátor podpory a záznamov |
| locale | šnúrky | Vybrané miestne nastavenie výstupu |
| mode | šnúrky | Vybraný režim zjednodušenia |
| output | šnúrky | Hotový výsledok vo vybratom miestnom nastavení výstupu |
| usage.inputCharacters | celkové číslo | Znaky započítané pre túto požiadavku alebo 0 pre prístup do vyrovnávacej pamäte |
| usage.cacheHit | boolovská hodnota | Či výsledok pochádza z 30-dňovej vyrovnávacej pamäte |
{
"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.