API vienkāršā valoda un vieglā valoda.
Nosūtīt savu pirmtekstu, vēlamo mērķa valodu un vienu no diviem valodas režīmiem. Simple8 automātiski atpazīst avota valodu un atgriež gatavo tekstu mērķa valodā.
{
"text": "Sarežģīts avota saturs atlasītajā valodā.",
"locale": "lv",
"mode": "simple-language"
}Pieejami SDK un cURL piemēri
Galvenā punkta
POST /api/v2/translate
Izveido tekstu vienkāršā vai vienkāršā valodā un atgriež to tieši HTTP atbildē.
Vajadzīgi virsraksti
| Galvenā | Valūta | Nodrošinājums |
|---|---|---|
| Authorization | Bearer <API_KEY> | Darbvietas autentifikācija |
| Content-Type | pieteikums/json | Norāda, ka pieprasījumā ir JSON |
| Accept | pieteikums/json | Pieteikums JSON atbildi |
| Idempotency-Key | Nepieciešami tikai fona un beztaras pasūtījumiem | Novērš fona rīkojumu dublēšanu |
Pieprasījuma struktūra
Neviens cits satura iestatījums neietilpst publiskā pieprasījuma shēmā.
| Lauka | Tips | Vajadzība | Pieļaujama vērtība | Apzīmējums |
|---|---|---|---|---|
| text | ķēdes | Jā, tā ir. | No 1 līdz 5 000 NFC normalizētiem Unicode koda punktiem | Avota teksts |
| locale | ķēdes | Jā, tā ir. | Viens no 136 atbalstītajiem 2 vai 3 burtu kodiem | Izvades valoda. Avota valoda tiek noteikta automātiski. |
| mode | ķēdes | Jā, tā ir. | simple-language, easy-language | vienkāršošanas režīms |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Reakcijas struktūra
Atbilde satur pabeigtu tekstu un dokumentētus lietošanas datus.
| Lauka | Tips | Apzīmējums |
|---|---|---|
| requestId | ķēdes | Vienotīgs identifikators atbalsta un žurnāla vajadzībām |
| locale | ķēdes | Izvēlētā mērķa valoda |
| mode | ķēdes | Izvēlēts vienkāršošanas režīms |
| output | ķēdes | Gatavs teksts izvēlētajā mērķa valodā |
| usage.inputCharacters | pilns skaitlis | Šim pieprasījumam tiek ieskaitītas rakstzīmes vai 0 - kešatmiņas trāpījumam |
| usage.cacheHit | Būla | Neatkarīgi no tā, vai rezultāts tika iegūts no 180 dienu kešatmiņas |
{
"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
}
}Validācijas uzvedība
- Trūkstoši, tukši, nezināmi vai nederīgi lauki atgriež HTTP 400 ar kļūdas kodu invalid_request un validācijas informāciju.
- Teksta garumu mēra Unicode koda punktos pēc NFC normalizācijas.
- Lokālei jābūt vienam no 136 dokumentētajiem 2 vai 3 burtu kodiem.
- Režīmam jābūt tieši simple-language vai easy-language.
- Simple8 automātiski atpazīst avota teksta valodu un rada rezultātu izvēlētajā mērķa valodā.