Dokumentatsioon

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

PeakordTõlkeEesmärk
AuthorizationBearer <API_KEY>Autentib projekti praeguse HTTP kandja skeemiga
Content-Typetaotlus/tööaegTaotluse formaat deklareeritakse
Accepttaotlus/tööaegNõubab JSON vastust
Idempotency-KeyNõutav ainult tööde ja partiide jaoksHoiab korduvatel asünkroonsetel esitustel dubleeriva töö

Taotlusasutus

Ükski muu sisuseade ei kuulu avaliku päringu skeemi.

TöötTüüpNõutavLõigustatud väärtusMärkus
textridaJah, ma olen.1 kuni 10 000 Unicode'i tähemärkiValitud kohapealse allikand
localeridaJah, ma olen.Üks 24 toetatud kahe kirja koodistVäljundi keel. Lähtekeel tuvastatakse automaatselt.
moderidaJah, ma olen.lihtsat keelt, kerget keeltLihtsendamise viis
json
{
  "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öötTüüpMärkus
requestIdridaToetuse ja logide unikaalne tunnistus
localeridaValitud väljundi lokaat
moderidaValitud lihtsustamise mood
outputridaValmis tulemus valitud väljundi lokaadis
usage.inputCharacterstäisarvSelle päringu puhul loendati tähemärke või vahemälu tabamuse puhul 0
usage.cacheHittõeväärtusKas tulemus tuli 30-päevasest vahemälust
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
  }
}

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.