Dokumentacija

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

VlagalnikVrednostNamen
AuthorizationBearer <API_KEY>Preverja pristnost projekta s trenutno shemo nosilca HTTP
Content-Typeaplikacija/jsonIzjava oblika telesa zahtevka
Acceptaplikacija/jsonZahteva odgovor JSON
Idempotency-KeyZahtevano samo za opravila in paketePreprečuje ponavljajoče se asinhrone oddaje pred ustvarjanjem podvojenega dela

Organ za zahtevo

Nobena druga nastavitev vsebine ni del sheme javne zahteve.

PoljeVrstaZahtevaneDovolila vrednostOpis
textšneka-Ja, res.1 do 10.000 znakov UnicodeVpišeni vsebin v izbrani lokaciji
localešneka-Ja, res.Ena od 24 podprtih dvojlitojnih kodovIzhodni jezik. Izvorni jezik se zazna samodejno.
modešneka-Ja, res.preprost jezik, preprost jezikSposobnost poenostavitve
json
{
  "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.

PoljeVrstaOpis
requestIdšnekaEdinstven identifikator za podporo in dnevnike
localešnekaIzbrani jezik izhoda
modešnekaIzbran način poenostavitve
outputšnekaKončni rezultat v izbranem izhodnem jeziku
usage.inputCharacterscelotni številkaŠtevilo znakov za to zahtevo ali 0 za zadetek v predpomnilniku
usage.cacheHitlogičnoAli je rezultat prišel iz 30-dnevnega predpomnilnika
json
{
  "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.