API-ÜHINEK
Lihtsustage ja tõlkige sisu 24 väljundkeelde.
Sünkroonne lõpp-punkt aktsepteerib lähteteksti, väljundlokaati ja ühte kahest režiimist. See tuvastab lähtekeele automaatselt ja tagastab valitud väljundkeeles kasutusvalmis tulemuse.
{
"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
Looge üks lihtsa keele või lihtsa keele tulemus ja tagastage see samas HTTP vastuses.
Nõutavad pealkirjad
| Peakord | Tõlke | Eesmärk |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentib projekti praeguse HTTP kandja skeemiga |
| Content-Type | taotlus/tööaeg | Taotluse formaat deklareeritakse |
| Accept | taotlus/tööaeg | Nõubab JSON vastust |
| Idempotency-Key | Nõutav ainult tööde ja partiide jaoks | Hoiab korduvatel asünkroonsetel esitustel dubleeriva töö |
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 10 000 Unicode'i tähemärki | Valitud kohapealse allikand |
| locale | rida | Jah, ma olen. | Üks 24 toetatud kahe kirja koodist | Väljundi keel. Lähtekeel tuvastatakse automaatselt. |
| mode | rida | Jah, ma olen. | lihtsat keelt, kerget keelt | Lihtsendamise viis |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Reagendav asutus
Vastus ei tohi sisaldada tühistatud päringu seadeid ega eraldi kvaliteediteabe massiivi.
| Tööt | Tüüp | Märkus |
|---|---|---|
| requestId | rida | Toetuse ja logide unikaalne tunnistus |
| locale | rida | Valitud väljundi lokaat |
| mode | rida | Valitud lihtsustamise mood |
| output | rida | Valmis tulemus valitud väljundi lokaadis |
| 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 30-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
- Kinnitamata tekst: lükkage tagasi dokumenteeritud väljavastusega.
- Tekkis tekst: lükkage tagasi dokumenteeritud väljavastusega.
- Toetamata paikne: lükkage tagasi; mitte kunagi vaikselt asendage teine paikne.
- Toetamata režiim: lükkage tagasi; mitte kunagi automaatselt valida režiimi.
- Tundmatu pensionile jäänud välja: lülitada tagasi migreerimispõhise vea abil või käsitleda ainult eksplisiitvalt versioneeritud ühilduvusliina kaudu.
- Lähtetekst võib kasutada lokaadist erinevat keelt. Simple8 tuvastab lähtekeele automaatselt ja kirjutab tulemuse valitud väljundi lokaadis.