API pentru limbaj clar și format ușor de citit și de înțeles.
Trimite textul sursă, limba țintă dorită și unul dintre cele două moduri lingvistice. Simple8 recunoaște automat limba sursă și returnează textul finit în limba țintă.
{
"text": "Conținut sursă complex în limba selectată.",
"locale": "ro",
"mode": "simple-language"
}Sunt disponibile exemple SDK și cURL
Punctul final
POST /api/v2/translate
Creează un text în limbaj simplu sau ușor și îl returnează direct în răspunsul HTTP.
Titluri necesare
| Încheietura | Valori | Scopul |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentificarea spațiului de lucru |
| Content-Type | cerere/json | Indică faptul că cererea conține JSON |
| Accept | cerere/json | Require un răspuns JSON |
| Idempotency-Key | Numai pentru comenzile de fundal și vrac | Previne ordine de fundal duplicate |
Organism de cerere
Nicio altă setare de conținut nu face parte din schema de solicitare publică.
| Câmpă | Tipul | Required | Valor permis | Descriere |
|---|---|---|---|---|
| text | string | Da, nu. | De la 1 la 5.000 de puncte de cod Unicode normalizate NFC | Text sursă |
| locale | string | Da, nu. | Unul dintre cele 136 de coduri acceptate, formate din 2 sau 3 litere | Limba de ieșire. Limba sursă este detectată automat. |
| mode | string | Da, nu. | simple-language, easy-language | Modul de simplificare |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Organism de răspuns
Răspunsul conține textul finit și datele de utilizare documentate.
| Câmpă | Tipul | Descriere |
|---|---|---|
| requestId | string | Identificator unic pentru suport și jurnaluri |
| locale | string | Limba țintă selectată |
| mode | string | Modul de simplificare selectat |
| output | string | Text gata în limba țintă selectată |
| usage.inputCharacters | număr întreg | Caracterele numărate pentru această solicitare sau 0 pentru o accesare în cache |
| usage.cacheHit | boolean | Dacă rezultatul a venit din memoria cache de 180 de zile |
{
"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
}
}Comportamentul de validare
- Câmpurile lipsă, goale, necunoscute sau nevalide returnează HTTP 400 cu codul de eroare invalid_request și detalii de validare.
- Lungimea textului se măsoară după normalizarea NFC, în puncte de cod Unicode.
- Setarea regională trebuie să fie unul dintre cele 136 de coduri documentate, formate din 2 sau 3 litere.
- Modul trebuie să fie exact simple-language sau easy-language.
- Simple8 recunoaște automat limba textului sursă și creează rezultatul în limba țintă selectată.