API selkeälle kielelle ja selkokielelle.
Lähetä lähdetekstisi, haluamasi kohdekieli ja toinen kahdesta kielitilasta. Simple8 tunnistaa automaattisesti lähdekielen ja palauttaa valmiin tekstin kohdekielellä.
{
"text": "Monimutkainen lähdesisältö valitulla kielellä.",
"locale": "fi",
"mode": "simple-language"
}SDK- ja cURL-esimerkkejä saatavilla
Lopputulos
POST /api/v2/translate
Luo selkeän tai selväkielisen tekstin ja palauttaa sen suoraan HTTP-vastaukseen.
Vaatimukset
| Päällystys | Arvonlisä | Tavoitteena |
|---|---|---|
| Authorization | Bearer <API_KEY> | Työtilan todennus |
| Content-Type | hakemus/json | Sanon, että kysely sisältää JSON |
| Accept | hakemus/json | Pyydetään JSON-vastausta |
| Idempotency-Key | Vaaditaan vain tausta- ja ryhmätilauksia varten | Välttää kaksois- taustahankinnat |
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-5 000 NFC-normalisoitua Unicode-koodipistettä | Käytännössä |
| locale | kytkö | - Kyllä , minä olen . | Yksi 136 tuetusta 2- tai 3-kirjaimisesta koodista | Tulostuskieli. Lähdekieli tunnistetaan automaattisesti. |
| mode | kytkö | - Kyllä , minä olen . | simple-language, easy-language | Yksinkerentämistila |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Vastausorganisaatio
Vastaus sisältää valmiin tekstin ja dokumentoidun käyttötiedot.
| Maaseutu | Tyyppinen | Kuvaus |
|---|---|---|
| requestId | kytkö | Tukea ja logia koskevat ainutlaatuiset tunnisteet |
| locale | kytkö | Valittu kohdekieli |
| mode | kytkö | Valitu yksinkertaistamismuodi |
| output | kytkö | Valmis teksti valitulla kohdekielellä |
| usage.inputCharacters | täysmäärä | Tähän pyyntöön lasketaan merkkejä tai välimuistiosumalle 0 |
| usage.cacheHit | boolean | Tuliko tulos 180 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ö
- Puuttuvat, tyhjät, tuntemattomat tai virheelliset kentät palauttavat HTTP 400 -vastauksen, virhekoodin invalid_request ja vahvistuksen tiedot.
- Tekstin pituus mitataan NFC-normalisoinnin jälkeen Unicode-koodipisteinä.
- Alueasetuksen on oltava yksi 136 dokumentoidusta 2- tai 3-kirjaimisesta koodista.
- Tilan on oltava täsmälleen simple-language tai easy-language.
- Lähdeteksti voi olla kirjoitettu muullakin kuin määritellyllä kielellä. Simple8 tunnistaa kielen automaattisesti ja luo tuloksen valitulla kohdekielellä.