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

Porovnajte priame odpovede, streaming, pozadie práce a webhooks. Všetky varianty používajú textový, jazykový kód a režim.

Koncový bod

POST /api/v2/translate

Najlepšie pre

Krátke texty, ktorých výsledok je potrebný okamžite.

Úspech

200 OK

Streaming

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

Koncový bod

POST /api/v2/translate/stream

Najlepšie pre

Pre dlhší obsah, ktorého výsledok by mal byť zobrazený postupne.

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

Potok začína meta. Potom nasleduje jedna alebo viac častí textu ako delta. Hotová udalosť dokončí odpoveď s údajmi o použití.

Prvá udalosť obsahuje ID žiadosti, hlasový kód 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. Pri opakovaných pokusoch použite rovnaký kľúč bez počiatočných a koncových medzier s dĺžkou 1 až 255 znakov. Prvé vytvorenie vráti 202, opakované odoslanie vráti 200.

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",
  "expiresAt": "2026-09-03T12:00:00.000Z"
}

{
  "jobId": "job_poll_001",
  "status": "completed",
  "locale": "fr",
  "mode": "simple-language",
  "output": "Simplified content in French.",
  "expiresAt": "2026-09-03T12:00:00.000Z"
}

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

Úloha prechádza stavmi queued, processing, completed alebo failed. Neúspešné úlohy obsahujú error.code. Odpovede na vytvorenie a stav obsahujú expiresAt.

Najprv požiadajte o status znovu po jednej sekunde. Zvyšovať vzdialenosť postupne s dlhším spracovaním.

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 odosiela Simple8-Signature vo formáte t=<timestamp>,v1=<signature>. <timestamp> je unixová časová pečiatka v sekundách. Podpis je výstup HMAC SHA-256 z <timestamp>.<raw request body> zapísaný malými hexadecimálnymi znakmi.

Skontrolujte podpis na základe nezmenenej žiadosti. Po vytvorení koncového bodu uvidíte tajný podpisový kľúč.

Hneď ako váš systém udalosť prijme, vráťte HTTP 200 alebo 201.

Opakuje: V prípade chyby, Simple8 pokusy dodanie až 50 krát do siedmich dní. Posledné pokusy v aplikácii môžete vidieť.

Duplikovať udalosti: Spracovať každé ID udalosti len raz, ako opakovanie môže pokračovať v rovnakej udalosti.

Dávkové spracovanie

Odošlite 1 až 50 položiek s celkovým maximálnym počtom 25 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.

{
  "items": [
    {
      "text": "First source text.",
      "locale": "en",
      "mode": "simple-language"
    },
    {
      "text": "Second source text.",
      "locale": "de",
      "mode": "easy-language"
    }
  ],
  "delivery": {
    "type": "polling"
  }
}

{
  "batchId": "batch_001",
  "status": "queued",
  "itemCount": 2
}

{
  "batchId": "batch_001",
  "status": "completed",
  "itemCount": 2,
  "items": [
    {
      "jobId": "job_001",
      "status": "completed",
      "locale": "en",
      "mode": "simple-language",
      "output": "First result."
    },
    {
      "jobId": "job_002",
      "status": "failed",
      "locale": "de",
      "mode": "easy-language",
      "error": {
        "code": "processing_failed"
      }
    }
  ]
}

Vytvorenie dávky vráti prvýkrát HTTP 202 a pri idempotentnom opakovaní HTTP 200. Webhook udalosti sú job.completed, job.failed, batch.completed a batch.failed. Payloady dokončených webhookov obsahujú iba identifikátory a stav. Výstup získate z endpointu stavu úlohy alebo dávky.

Na tejto stránke

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

Začnite zadarmo používať Simple8.