API selge keel ja lihtne keel jaoks.
Saatke oma lähtetekst, soovitud sihtkeel ja üks kahest keelerežiimist. Simple8 tuvastab automaatselt lähtekeele ja tagastab valmis teksti sihtkeeles.
{
"text": "Keeruline lähtesisu valitud keeles.",
"locale": "et",
"mode": "simple-language"
}Saadaval on SDK ja cURL-i näited
Lõpppunkt
POST /api/v2/translate
Loob liht- või lihtkeelse teksti ja tagastab selle otse HTTP vastuses.
Nõutavad pealkirjad
| Peakord | Tõlke | Eesmärk |
|---|---|---|
| Authorization | Bearer <API_KEY> | Tööruumi autentimine |
| Content-Type | taotlus/tööaeg | Märgib, et päring sisaldab JSON |
| Accept | taotlus/tööaeg | Nõubab JSON vastust |
| Idempotency-Key | Nõutav ainult tausta- ja kollektiivtellimuste puhul | Väldib kahekordseid taustaühendusi |
Taotlusasutus
Ükski muu sisuseade ei kuulu avaliku päringu skeemi.
| Tööt | Tüüp | Nõutav | Lõigustatud väärtus | Märkus |
|---|---|---|---|---|
| text | rida | Jah, ma olen. | 1 kuni 5 000 NFC-normaliseeritud Unicode'i koodipunkti | Põhjaskest |
| locale | rida | Jah, ma olen. | Üks 136 toetatud 2- või 3-tähelisest koodist | Väljundi keel. Lähtekeel tuvastatakse automaatselt. |
| mode | rida | Jah, ma olen. | simple-language, easy-language | Lihtsendamise viis |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Reagendav asutus
Vastus sisaldab valmis teksti ja dokumenteeritud kasutusandmeid.
| Tööt | Tüüp | Märkus |
|---|---|---|
| requestId | rida | Toetuse ja logide unikaalne tunnistus |
| locale | rida | Valitud sihtkeel |
| mode | rida | Valitud lihtsustamise mood |
| output | rida | Valmis tekst valitud sihtkeeles |
| usage.inputCharacters | täisarv | Selle päringu puhul loendati tähemärke või vahemälu tabamuse puhul 0 |
| usage.cacheHit | tõeväärtus | Kas tulemus tuli 180-päevasest vahemälust |
{
"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
}
}Valideerimiskäitumine
- Puuduvad, tühjad, tundmatud või kehtetud väljad tagastavad HTTP 400 koos veakoodi invalid_request ja valideerimise üksikasjadega.
- Teksti pikkust mõõdetakse pärast NFC-normaliseerimist Unicode'i koodipunktides.
- Lokaat peab olema üks 136 dokumenteeritud 2- või 3-tähelisest koodist.
- Režiim peab olema täpselt simple-language või easy-language.
- Lähtetekst võib olla kirjutatud ka muus keeles, kui ei ole nimetatud. Simple8 tuvastab keele automaatselt ja loob tulemuse valitud sihtkeeles.