API atsauce
Vienkāršojiet un tulkojiet saturu 24 izvades valodās.
Sinhronais galapunkts pieņem avota tekstu, izvades lokalizāciju un vienu no diviem režīmiem. Tas automātiski nosaka avota valodu un atgriež lietošanai gatavu rezultātu atlasītajā izvades 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
Izveidojiet vienu vienkāršās valodas vai vienkāršas valodas rezultātu un atgrieziet to tajā pašā HTTP atbildē.
Vajadzīgi virsraksti
| Galvenā | Valūta | Nodrošinājums |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentificē projektu ar pašreizējo HTTP nesēja shēmu |
| Content-Type | pieteikums/json | Izvēlas pieprasījuma struktūras formātu |
| Accept | pieteikums/json | Pieteikums JSON atbildi |
| Idempotency-Key | Nepieciešams tikai darbiem un partijām | Neļauj atkārtotiem asinhroniem iesniegumiem radīt dublētus darbus |
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 10 000 unikoda rakstzīmēm | Izvēlētajā vietnē ir avota saturs |
| locale | ķēdes | Jā, tā ir. | Viens no 24 atbalstītajiem divstoņveida kodiem | Izvades valoda. Avota valoda tiek noteikta automātiski. |
| mode | ķēdes | Jā, tā ir. | vienkārša, vienkārša valoda | vienkāršošanas režīms |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Reakcijas struktūra
Atbildē nedrīkst būt ietverti anulēti pieprasījuma iestatījumi vai atsevišķs kvalitātes informācijas masīvs.
| Lauka | Tips | Apzīmējums |
|---|---|---|
| requestId | ķēdes | Vienotīgs identifikators atbalsta un žurnāla vajadzībām |
| locale | ķēdes | Atlasītā izvades lokalizācija |
| mode | ķēdes | Izvēlēts vienkāršošanas režīms |
| output | ķēdes | Pabeigts rezultāts atlasītajā izvades lokalizācijā |
| 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 30 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
- Izmantojot tekstu: atmest ar dokumentētu lauku kļūdu.
- Tuvs teksts: atmest ar dokumentētu laukuma kļūdu.
- Neatbalsta vietne: noraidīt; nekad klusīgi aizstāt citu vietni.
- Neatbalsta režīms: noraidīt; nekad automātiski neizmantot režīmu.
- Neatzīstams atkāpjies laukums: noraidīt ar migrācijas koncentrēto kļūdu vai apstrādāt tikai ar skaidri izformētu saderības slogu.
- Avota tekstā var tikt izmantota valoda, kas atšķiras no lokalizācijas. Simple8 automātiski nosaka avota valodu un ieraksta rezultātu atlasītajā izvades lokalizācijā.