Dokumentácia

Vyberte si, ako váš systém dostane výsledok.

{
  "text": "Komplexný zdrojový obsah vo vybranom jazyku.",
  "locale": "sk",
  "mode": "simple-language"
}

K dispozícii sú príklady SDK a cURL

Synchronné HTTP

Každý vzor používa rovnaké základné polia: text, miestne nastavenie a režim.

Koncový bod

POST /api/v2/translate

Najlepšie pre

Krátky obsah a priame záložné akcie.

Úspech

200 OK

Streaming

Odpoveď používa Content-Type: text/event-stream.

Koncový bod

POST /api/v2/translate/stream

Najlepšie pre

Progresívne rozhranie a dlhší obsah.

{
  "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}}

Prúd vysiela jednu meta udalosť, jednu alebo viacero delta udalostí a poslednú hotovú udalosť.

Meta udalosť obsahuje identifikátor požiadavky, miestne nastavenie a režim.

Každá delta obsahuje časť výsledku a done obsahuje informácie o použití.

Po dokončení sa spojenie uzavrie.

Asynchronizovaná práca s hlasovaním

Pri vytváraní úlohy odošlite jedinečnú hlavičku Idempotency-Key.

Vytvorenie koncového bodu

POST /api/v2/jobs

Koncový bod stavu

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."
  }
}

Úlohy zostávajú k dispozícii sedem dní.

Hlasujte v primeranom intervale, kým sa stav nedokončí alebo zlyhá.

Asynchronizácia s webhookom

Najprv vytvorte a overte koncový bod webhooku v aplikácii Simple8. Potom v úlohe uveďte odkaz na jeho ID koncového bodu.

Vytvorenie koncového bodu

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 odošle hlavičku Simple8-Signature s časovou pečiatkou a podpisom HMAC SHA-256.

Overte podpis oproti nespracovanému telu požiadavky s podpisovým tajomstvom zobrazeným raz pri vytváraní koncového bodu.

Po prijatí udalosti vráťte akýkoľvek stav 2xx.

Neúspešné doručenia sa opakujú až 50-krát počas siedmich dní a nedávne pokusy sú viditeľné v aplikácii.

Príjemcovia musia tolerovať duplicitné doručenie, pretože opakované pokusy môžu doručiť rovnakú udalosť viac ako raz.

Dávkové spracovanie

Odošlite 1 až 50 položiek s celkovým maximálnym počtom 500 000 znakov.

Vytvorenie koncového bodu

POST /api/v2/batches

Koncový bod stavu

GET /api/v2/batches/{id}

Každá položka používa rovnaký text, miestne nastavenie a polia režimu ako synchrónna požiadavka.

Vyberte si prieskum alebo overený koncový bod webhooku na doručenie a odošlite jedinečnú hlavičku Idempotency-Key.

Na tejto stránke