API, skirta paprasta kalba ir lengvai suprantama kalba.
Siųsti pradinį tekstą, norimą tikslinę kalbą ir vieną iš dviejų kalbos režimų. Simple8 automatiškai atpažįsta šaltinio kalbą ir grąžina užbaigtą tekstą tiksline kalba.
{
"text": "Sudėtingas šaltinio turinys pasirinkta kalba.",
"locale": "lt",
"mode": "simple-language"
}Galimi SDK ir cURL pavyzdžiai
Baigiamasis punktas
POST /api/v2/translate
Sukuria tekstą paprasta arba paprasta kalba ir grąžina jį tiesiai HTTP atsakymo.
Reikalingos antraštinės dalys
| Škyros | Vertybė | Paslaugos |
|---|---|---|
| Authorization | Bearer <API_KEY> | Darbo srities autentifikavimas |
| Content-Type | prašymas/json | Nurodo, kad prašyme yra JSON |
| Accept | prašymas/json | Prašo JSON atsakymo |
| Idempotency-Key | Tik foniniams ir didmeniniams užsakymams | Apsaugo nuo pasikartojančių fono užsakymų |
Prašymo įstaiga
Joks kitas turinio nustatymas nėra viešosios užklausos schemos dalis.
| Laikas | Tipas | Reikalingas | Leistina vertė | Aprašymas |
|---|---|---|---|---|
| text | eilutės | Taip. | Nuo 1 iki 5 000 pagal NFC normalizuotų Unicode kodo taškų | Šaltinio tekstas |
| locale | eilutės | Taip. | Vienas iš 136 palaikomų 2 arba 3 raidžių kodų | Išvesties kalba. Šaltinio kalba aptinkama automatiškai. |
| mode | eilutės | Taip. | simple-language, easy-language | Paprastinimo būdas |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Reakcijos įstaiga
Atsakyme pateikiamas baigtas tekstas ir dokumentuoti naudojimo duomenys.
| Laikas | Tipas | Aprašymas |
|---|---|---|
| requestId | eilutės | Unikali paramos ir žurnalo identifikavimo ženklas |
| locale | eilutės | Pasirinkta paskirties kalba |
| mode | eilutės | Pasirinktas supaprastinimo režimas |
| output | eilutės | Ruošiamas tekstas pasirinkta paskirties kalba |
| usage.inputCharacters | vienetas | Šiai užklausai skaičiuojami simboliai arba 0 talpyklos įvykiui |
| usage.cacheHit | loginis | Nesvarbu, ar rezultatas buvo gautas iš 180 dienų talpyklos |
{
"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
}
}Validacijos elgesys
- Jei laukai nepateikti, tušti, nežinomi arba netinkami, grąžinamas HTTP 400 su klaidos kodu invalid_request ir tikrinimo informacija.
- Teksto ilgis matuojamas Unicode kodo taškais po NFC normalizavimo.
- Lokalė turi būti vienas iš 136 dokumentuotų 2 arba 3 raidžių kodų.
- Režimas turi būti tiksliai simple-language arba easy-language.
- Simple8 automatiškai atpažįsta pradinio teksto kalbą ir sukuria į pasirinktą tikslinę kalbą rezultatą.