Dokumentaatio

API-viittaus

Yksinkertaista ja käännä sisältö 24 kielelle.

Synkroninen päätepiste hyväksyy lähdetekstin, tulostusalueen ja toisen kahdesta tilasta. Se tunnistaa lähdekielen automaattisesti ja palauttaa käyttövalmiin tuloksen valitulla tulostuskielellä.

{
  "text": "Monimutkainen lähdesisältö valitulla kielellä.",
  "locale": "fi",
  "mode": "simple-language"
}

SDK- ja cURL-esimerkkejä saatavilla

Lopputulos

POST /api/v2/translate

Luo yksi Plain Language tai Easy Language -tulos ja palauta se samassa HTTP-vastauksessa.

Vaatimukset

PäällystysArvonlisäTavoitteena
AuthorizationBearer <API_KEY>Todentaa projektin nykyisellä HTTP Bearer -mallilla
Content-Typehakemus/jsonIlmoitetaan pyynnön muodostuminen
Accepthakemus/jsonPyydetään JSON-vastausta
Idempotency-KeyVaaditaan vain töissä ja erissäEstää toistuvia asynkronisia lähetyksiä luomasta päällekkäisiä töitä

Pyynnön esittävä elin

Mikään muu sisältöasetus ei ole osa julkisen pyynnön mallia.

MaaseutuTyyppinenVaatimuksetSallittu arvoKuvaus
textkytkö- Kyllä , minä olen .1-10 000 Unicode-merkkiäLähteen sisältö valitussa paikassa
localekytkö- Kyllä , minä olen .Yksi 24 tukituista kahden kirjaimen koodeistaTulostuskieli. Lähdekieli tunnistetaan automaattisesti.
modekytkö- Kyllä , minä olen .Yksinkertainen, helppo kieliYksinkerentämistila
json
{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Vastausorganisaatio

Vastaus ei saa sisältää poistettuja pyyntöasetuksia tai erillistä laatutietotaulukkoa.

MaaseutuTyyppinenKuvaus
requestIdkytköTukea ja logia koskevat ainutlaatuiset tunnisteet
localekytköValittu lähtöalue
modekytköValitu yksinkertaistamismuodi
outputkytköValmiit tulos valitulla tulostuspaikalla
usage.inputCharacterstäysmääräTähän pyyntöön lasketaan merkkejä tai välimuistiosumalle 0
usage.cacheHitbooleanTuliko tulos 30 päivän välimuistista
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
  }
}

Validointikäytäntö

  • Puuttuva teksti: hylkää dokumenttoitu kenttävirhe.
  • Tyhjät tekstit: hylkää dokumenttoitu kenttävirhe.
  • Tuettua paikallista: hylkää; älä koskaan äänettömästi korvaa toista paikallista.
  • Toimittajan työkalu: hylkää; älä koskaan valitse automaattisesti tilaa.
  • Tunnettamaton eläkkeellä oleva kenttä: hylkää siirtymäkohtaisesti kohdistettu virhe tai käsittele vain nimenomaisesti versioitu yhteensopivuuslaatu.
  • Lähdeteksti voi käyttää eri kieltä kuin maa-asetus. Simple8 tunnistaa lähdekielen automaattisesti ja kirjoittaa tuloksen valitulle lähtökielelle.