Dokumentace

Vyberte si, jak váš systém dostane výsledek.

{
  "text": "Komplexní zdrojový obsah ve zvoleném jazyce.",
  "locale": "cs",
  "mode": "simple-language"
}

Dostupné příklady SDK a cURL

Synchronní HTTP

Každý vzor používá stejná základní pole: text, národní prostředí a režim.

Výsledný bod

POST /api/v2/translate

Nejlepší pro

Krátký obsah a přímé záložní akce.

Úspěch

200 OK

Střímací

Odpověď používá Content-Type: text/event-stream.

Výsledný bod

POST /api/v2/translate/stream

Nejlepší pro

Progresivní rozhraní a delší 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}}

Proud vysílá jednu meta událost, jednu nebo více událostí delta a závěrečnou událost hotovo.

Meta událost obsahuje identifikátor požadavku, národní prostředí a režim.

Každá delta obsahuje část výsledku a done obsahuje informace o použití.

Po dokončení se spojení uzavře.

Asynchronizace práce s průzkumy

Při vytváření úlohy odešlete jedinečnou hlavičku Idempotency-Key.

Vytvořit koncový bod

POST /api/v2/jobs

Status koncového bodu

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

Úkoly zůstávají k dispozici sedm dní.

Dotazujte se v přiměřeném intervalu, dokud nebude stav dokončen nebo selže.

Asynchronizace s webhookem

Nejprve vytvořte a ověřte koncový bod webhooku v aplikaci Simple8. Potom v úloze odkazujte na jeho ID koncového bodu.

Vytvořit koncový bod

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 odešle hlavičku Simple8-Signature s časovým razítkem a podpisem HMAC SHA-256.

Ověřte podpis proti nezpracovanému tělu požadavku pomocí tajného klíče podpisu, který se zobrazí jednou při vytvoření koncového bodu.

Po přijetí události vraťte jakýkoli stav 2xx.

Neúspěšné doručení je opakováno až 50krát za sedm dní a nedávné pokusy jsou viditelné v aplikaci.

Příjemci musí tolerovat duplicitní doručení, protože opakované pokusy mohou doručit stejnou událost více než jednou.

Dávkové zpracování

Odešlete 1 až 50 položek s celkovým maximálním počtem 500 000 znaků.

Vytvořit koncový bod

POST /api/v2/batches

Status koncového bodu

GET /api/v2/batches/{id}

Každá položka používá stejný text, národní prostředí a pole režimu jako synchronní požadavek.

Vyberte dotazování nebo ověřený koncový bod webhooku pro doručení a odešlete jedinečnou hlavičku Idempotency-Key.

Na této stránce