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äällystys | Arvonlisä | Tavoitteena |
|---|---|---|
| Authorization | Bearer <API_KEY> | Todentaa projektin nykyisellä HTTP Bearer -mallilla |
| Content-Type | hakemus/json | Ilmoitetaan pyynnön muodostuminen |
| Accept | hakemus/json | Pyydetään JSON-vastausta |
| Idempotency-Key | Vaaditaan 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.
| Maaseutu | Tyyppinen | Vaatimukset | Sallittu arvo | Kuvaus |
|---|---|---|---|---|
| text | kytkö | - Kyllä , minä olen . | 1-10 000 Unicode-merkkiä | Lähteen sisältö valitussa paikassa |
| locale | kytkö | - Kyllä , minä olen . | Yksi 24 tukituista kahden kirjaimen koodeista | Tulostuskieli. Lähdekieli tunnistetaan automaattisesti. |
| mode | kytkö | - Kyllä , minä olen . | Yksinkertainen, helppo kieli | Yksinkerentämistila |
{
"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.
| Maaseutu | Tyyppinen | Kuvaus |
|---|---|---|
| requestId | kytkö | Tukea ja logia koskevat ainutlaatuiset tunnisteet |
| locale | kytkö | Valittu lähtöalue |
| mode | kytkö | Valitu yksinkertaistamismuodi |
| output | kytkö | Valmiit tulos valitulla tulostuspaikalla |
| usage.inputCharacters | täysmäärä | Tähän pyyntöön lasketaan merkkejä tai välimuistiosumalle 0 |
| usage.cacheHit | boolean | Tuliko tulos 30 päivän välimuistista |
{
"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.