API za jasen jezik in lahko berljivo ter razumljivo obliko.
Pošljite izvorno besedilo, želeni ciljni jezik in enega od dveh jezikovnih načinov. Simple8 samodejno prepozna izvorni jezik in vrne končno besedilo v ciljnem jeziku.
{
"text": "Kompleksna izvorna vsebina v izbranem jeziku.",
"locale": "sl",
"mode": "simple-language"
}Na voljo so primeri SDK in cURL
Končna točka
POST /api/v2/translate
Ustvari besedilo v preprostem ali enostavnem jeziku in ga vrne neposredno v odgovor HTTP.
Zahtevane glave
| Vlagalnik | Vrednost | Namen |
|---|---|---|
| Authorization | Bearer <API_KEY> | Preverjanje pristnosti delovnega prostora |
| Content-Type | aplikacija/json | Navedba, da zahteva vsebuje JSON |
| Accept | aplikacija/json | Zahteva odgovor JSON |
| Idempotency-Key | Zahteva se samo za osnovne in velike naročila | Preprečuje podvajanje osnovnih naročil |
Organ za zahtevo
Nobena druga nastavitev vsebine ni del sheme javne zahteve.
| Polje | Vrsta | Zahtevane | Dovolila vrednost | Opis |
|---|---|---|---|---|
| text | šneka | -Ja, res. | Od 1 do 5.000 kodnih točk Unicode, normaliziranih z NFC | Izvorno besedilo |
| locale | šneka | -Ja, res. | Ena od 136 podprtih 2- ali 3-črkovnih kod | Izhodni jezik. Izvorni jezik se zazna samodejno. |
| mode | šneka | -Ja, res. | simple-language, easy-language | Sposobnost poenostavitve |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Odzivni organ
Odgovor vsebuje končno besedilo in dokumentirane podatke o uporabi.
| Polje | Vrsta | Opis |
|---|---|---|
| requestId | šneka | Edinstven identifikator za podporo in dnevnike |
| locale | šneka | Izbran ciljni jezik |
| mode | šneka | Izbran način poenostavitve |
| output | šneka | Pripravljeno besedilo v izbranem ciljnem jeziku |
| usage.inputCharacters | celotni številka | Število znakov za to zahtevo ali 0 za zadetek v predpomnilniku |
| usage.cacheHit | logično | Ali je rezultat prišel iz 180-dnevnega predpomnilnika |
{
"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
}
}Obnašanje potrjevanja
- Manjkajoča, prazna, neznana ali neveljavna polja vrnejo HTTP 400 s kodo napake invalid_request in podrobnostmi preverjanja.
- Dolžina besedila se meri po normalizaciji NFC v kodnih točkah Unicode.
- Jezikovna oznaka mora biti ena od 136 dokumentiranih 2- ali 3-črkovnih kod.
- Način mora biti natančno simple-language ali easy-language.
- Simple8 samodejno prepozna jezik izvornega besedila in ustvari rezultat v izbranem ciljnem jeziku.