Referință la API
Simplificați și traduceți conținutul în 24 de limbi de ieșire.
Punctul final sincron acceptă textul sursă, un local de ieșire și unul dintre cele două moduri. Detectează automat limba sursă și returnează un rezultat gata de utilizare în limba de ieșire selectată.
{
"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
Creați un rezultat în limbaj simplu sau în limbaj ușor și returnați-l în același răspuns HTTP.
Titluri necesare
| Încheietura | Valori | Scopul |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentifică proiectul cu schema curentă HTTP Bearer |
| Content-Type | cerere/json | Declarează formatul corpului de cerere |
| Accept | cerere/json | Require un răspuns JSON |
| Idempotency-Key | Necesar numai pentru lucrări și loturi | Împiedică trimiterile asincrone repetate să creeze lucrări 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. | 1 până la 10.000 de caractere Unicode | Conținutul sursă în localitatea selectată |
| locale | string | Da, nu. | Unul dintre cele 24 de coduri de două litere suportate | Limba de ieșire. Limba sursă este detectată automat. |
| mode | string | Da, nu. | limbajul simplu, limbajul simplu | Modul de simplificare |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Organism de răspuns
Răspunsul nu trebuie să conțină setări de solicitare retrase sau o matrice separată de informații despre calitate.
| Câmpă | Tipul | Descriere |
|---|---|---|
| requestId | string | Identificator unic pentru suport și jurnaluri |
| locale | string | Localizare de ieșire selectată |
| mode | string | Modul de simplificare selectat |
| output | string | Rezultatul final în localitatea de ieșire 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 30 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
- Text lipsit: respingere cu o eroare de câmp documentată.
- Text gol: respinge cu o eroare de câmp documentată.
- Locul nesuportat: respinge; niciodată nu înlocuiește în tăcere alt loc.
- Modul nesuportat: respinge; nu alegeți niciodată un mod automat.
- Câmpul retras necunoscut: respinge cu o eroare axată pe migrație sau gestionează numai printr-un strat de compatibilitate cu versiuni explicite.
- Textul sursă poate folosi o limbă diferită de cea locală. Simple8 detectează automat limba sursă și scrie rezultatul în localitatea de ieșire selectată.