API pre zrozumiteľný jazyk a ľahko čitateľný jazyk.
Pošlite svoj zdrojový text, požadovaný cieľový jazyk a jeden z dvoch jazykových režimov. Simple8 automaticky rozpozná zdrojový jazyk a vráti hotový text v cieľovom 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
Vytvorí text v jednoduchom alebo jednoduchom jazyku a vráti ho priamo v odpovedi HTTP.
Vyžadované nadpisy
| Vklad | Hodnota | Účelom |
|---|---|---|
| Authorization | Bearer <API_KEY> | Overenie pracovného priestoru |
| Content-Type | žiadosť/json | Označuje, že žiadosť obsahuje JSON |
| Accept | žiadosť/json | Žiada odpoveď JSON |
| Idempotency-Key | Požaduje sa len pre podkladové a hromadné objednávky | Zabraňuje duplicitným príkazom na pozadí |
Ž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ž 5 000 bodov kódu Unicode normalizovaných pomocou NFC | Zdrojový text |
| locale | šnúrky | Áno, áno. | Jeden zo 136 podporovaných dvoj- alebo trojpísmenových kódov | Výstupný jazyk. Zdrojový jazyk sa zistí automaticky. |
| mode | šnúrky | Áno, áno. | simple-language, easy-language | Príčin zjednodušenia |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Odpoveďový orgán
Odpoveď obsahuje hotový text a zdokumentované údaje o používaní.
| Poľa | Typ | Opis |
|---|---|---|
| requestId | šnúrky | Jedinečný identifikátor podpory a záznamov |
| locale | šnúrky | Vybraný cieľový jazyk |
| mode | šnúrky | Vybraný režim zjednodušenia |
| output | šnúrky | Pripravený text vo vybranom cieľovom jazyku |
| 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 180-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úce, prázdne, neznáme alebo neplatné polia vrátia HTTP 400 s kódom chyby invalid_request a podrobnosťami overenia.
- Dĺžka textu sa meria po normalizácii NFC v bodoch kódu Unicode.
- Miestne nastavenie musí byť jedným zo 136 zdokumentovaných dvoj- alebo trojpísmenových kódov.
- Režim musí byť presne simple-language alebo easy-language.
- Simple8 automaticky rozpozná jazyk zdrojového textu a vytvorí výsledok vo vybranom cieľovom jazyku.