Dokumentacija

Pasirinkite, kaip jūsų sistema gauna rezultatą.

{
  "text": "Sudėtingas šaltinio turinys pasirinkta kalba.",
  "locale": "lt",
  "mode": "simple-language"
}

Galimi SDK ir cURL pavyzdžiai

Sinkroninis HTTP

Kiekviename šablone naudojami tie patys pagrindiniai laukai: tekstas, lokalė ir režimas.

Baigiamasis punktas

POST /api/v2/translate

Geriausia

Trumpas turinys ir tiesioginiai paskutinio lygio veiksmai.

Išvykimas

200 Gerai

Stereo

Atsakyme naudojamas turinio tipas: tekstas / įvykio srautas.

Baigiamasis punktas

POST /api/v2/translate/stream

Geriausia

Progresyvūs sąsajos ir ilgesnis turinys.

{
  "text": "Source content in the selected language.",
  "locale": "en",
  "mode": "easy-language"
}

event: meta
data: {"requestId":"req_stream_001","locale":"en","mode":"easy-language"}

event: delta
data: {"delta":"Complete result."}

event: done
data: {"usage":{"inputCharacters":42,"cacheHit":false}}

Srautas skleidžia vieną metaįvykį, vieną ar daugiau delta įvykių ir galutinį baigtą įvykį.

Meta įvykyje yra užklausos identifikatorius, lokalė ir režimas.

Kiekviename delta yra dalis rezultato, o padaryta yra naudojimo informacija.

Atlikus ryšį, ryšys nutraukiamas.

Asinkronizuotas darbas su apklausais

Kurdami darbą nusiųskite unikalią Idempotency-Key antraštę.

Sukurti galutinį tašką

POST /api/v2/jobs

Statuso galutinis taškas

GET /api/v2/jobs/{id}

{
  "text": "Source content in the selected language.",
  "locale": "fr",
  "mode": "simple-language",
  "delivery": {
    "type": "polling"
  }
}

{
  "jobId": "job_poll_001",
  "status": "queued"
}

{
  "jobId": "job_poll_001",
  "status": "completed",
  "locale": "fr",
  "mode": "simple-language",
  "output": {
    "text": "Simplified content in French."
  }
}

Darbo vietos išlieka septynias dienas.

Apklausa pagrįstu intervalu, kol būsena baigta arba nepavyksta.

Asinkronizuotas darbas su "webhook"

Pirmiausia sukurkite ir patikrinkite „Webhook“ galinį tašką Simple8 programoje. Tada nurodykite jo galinio taško ID užduotyje.

Sukurti galutinį tašką

POST /api/v2/jobs

{
  "text": "Source content in the selected language.",
  "locale": "de",
  "mode": "easy-language",
  "delivery": {
    "type": "webhook",
    "endpointId": "00000000-0000-4000-8000-000000000000"
  }
}

{
  "id": "evt_01",
  "type": "job.completed",
  "createdAt": "2026-08-06T12:00:00.000Z",
  "data": {
    "jobId": "job_hook_001",
    "status": "completed"
  }
}

Simple8 siunčia Simple8-Signature antraštę su laiko žyma ir HMAC SHA-256 parašu.

Patikrinkite parašą pagal neapdorotos užklausos turinį su pasirašymo paslaptimi, rodoma vieną kartą, kai sukuriamas galutinis taškas.

Priėmę įvykį, grąžinkite bet kokią 2xx būseną.

Nesėkmingas pristatymas bandomas iš naujo iki 50 kartų per septynias dienas, o naujausi bandymai matomi programoje.

Gavėjai turi toleruoti pasikartojantį pristatymą, nes pakartotiniai bandymai gali pateikti tą patį įvykį daugiau nei vieną kartą.

Paketinis apdorojimas

Siųskite nuo 1 iki 50 elementų, kurių bendras ne daugiau kaip 500 000 simbolių.

Sukurti galutinį tašką

POST /api/v2/batches

Statuso galutinis taškas

GET /api/v2/batches/{id}

Kiekvienas elementas naudoja tuos pačius teksto, lokalės ir režimo laukus kaip sinchroninę užklausą.

Pasirinkite apklausą arba patvirtintą „Webhook“ galinį tašką pristatymui ir atsiųskite unikalią „Idempotency-Key“ antraštę.

Šiame puslapyje