Referenca na API
Poenostavite in prevedite vsebino v 24 izhodnih jezikov.
Sinhronska končna točka sprejema izvorno besedilo, izhodno področno nastavitev in enega od dveh načinov. Samodejno zazna izvorni jezik in vrne rezultat, pripravljen za uporabo, v izbranem izhodnem 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
Ustvarite en rezultat v preprostem ali preprostem jeziku in ga vrnite v istem odzivu HTTP.
Zahtevane glave
| Vlagalnik | Vrednost | Namen |
|---|---|---|
| Authorization | Bearer <API_KEY> | Preverja pristnost projekta s trenutno shemo nosilca HTTP |
| Content-Type | aplikacija/json | Izjava oblika telesa zahtevka |
| Accept | aplikacija/json | Zahteva odgovor JSON |
| Idempotency-Key | Zahtevano samo za opravila in pakete | Preprečuje ponavljajoče se asinhrone oddaje pred ustvarjanjem podvojenega dela |
Organ za zahtevo
Nobena druga nastavitev vsebine ni del sheme javne zahteve.
| Polje | Vrsta | Zahtevane | Dovolila vrednost | Opis |
|---|---|---|---|---|
| text | šneka | -Ja, res. | 1 do 10.000 znakov Unicode | Vpišeni vsebin v izbrani lokaciji |
| locale | šneka | -Ja, res. | Ena od 24 podprtih dvojlitojnih kodov | Izhodni jezik. Izvorni jezik se zazna samodejno. |
| mode | šneka | -Ja, res. | preprost jezik, preprost jezik | Sposobnost poenostavitve |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Odzivni organ
Odgovor ne sme vsebovati umaknjenih nastavitev zahteve ali ločenega niza informacij o kakovosti.
| Polje | Vrsta | Opis |
|---|---|---|
| requestId | šneka | Edinstven identifikator za podporo in dnevnike |
| locale | šneka | Izbrani jezik izhoda |
| mode | šneka | Izbran način poenostavitve |
| output | šneka | Končni rezultat v izbranem izhodnem 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 30-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
- Izgubljen besedil: zavrnite z dokumentirano napako polja.
- Prazen besedil: zavrnite z dokumentirano napako polja.
- Nepodporovano lokacijo: zavrnite; nikoli tiho ne zamenjate druge lokacije.
- Nepodpirani način: zavrnite; nikoli ne izberite načina samodejno.
- Neznano upokojeno polje: zavrnite z napako, usmerjeno na migracijo, ali se ukvarjate le z izrecno spremenjeno slojo združljivosti.
- Izvorno besedilo lahko uporablja jezik, ki se razlikuje od področnih nastavitev. Simple8 samodejno zazna izvorni jezik in zapiše rezultat v izbranem izhodnem jeziku.