Dokumentacija

Izberite kako vaš sustav prima rezultat.

{
  "text": "Složen izvorni sadržaj na odabranom jeziku.",
  "locale": "hr",
  "mode": "simple-language"
}

Dostupni primjeri SDK-a i cURL-a

Sinkronni HTTP

Svaki uzorak koristi ista temeljna polja: tekst, lokalizaciju i način.

Svrha

POST /api/v2/translate

Najbolje za

Kratak sadržaj i direktne backend akcije.

Uspjeh

200 OK

Streaming

Odgovor koristi Content-Type: text/event-stream.

Svrha

POST /api/v2/translate/stream

Najbolje za

Progresivni interfejs i duži sadržaj.

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

Stream emitira jedan meta događaj, jedan ili više delta događaja i posljednji završeni događaj.

Meta događaj sadrži identifikator zahtjeva, lokalizaciju i način.

Svaka delta sadrži dio rezultata, a done sadrži informacije o korištenju.

Nakon završetka, veza se zatvara.

Asynchronoidni posao s anketa

Pošaljite jedinstveno zaglavlje Idempotency-Key prilikom kreiranja posla.

Kreirajte krajnju tačku

POST /api/v2/jobs

Status krajnje točke

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

Posao ostaje dostupan sedam dana.

Anketirajte u razumnim intervalima dok se status ne završi ili ne uspije.

Async posao s webhook

Najprije izradite i provjerite krajnju točku web-dojavnika u aplikaciji Simple8. Zatim referencirajte njegov ID krajnje točke u poslu.

Kreirajte krajnju tačku

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 šalje zaglavlje Simple8-Signature s vremenskom oznakom i HMAC SHA-256 potpisom.

Provjerite potpis u odnosu na neobrađeno tijelo zahtjeva s tajnom potpisivanja prikazanom jednom prilikom stvaranja krajnje točke.

Vratite bilo koji status 2xx nakon prihvaćanja događaja.

Neuspjele isporuke pokušavaju se ponoviti do 50 puta tijekom sedam dana, a nedavni pokušaji vidljivi su u aplikaciji.

Primatelji moraju tolerirati dvostruku isporuku jer ponovni pokušaji mogu isporučiti isti događaj više puta.

Skupna obrada

Pošaljite između 1 i 50 stavki s kombiniranim maksimalno 500.000 znakova.

Kreirajte krajnju tačku

POST /api/v2/batches

Status krajnje točke

GET /api/v2/batches/{id}

Svaka stavka koristi isti tekst, lokalizaciju i polja načina rada kao sinkroni zahtjev.

Odaberite ispitivanje ili verificiranu krajnju točku web-dojavnika za isporuku i pošaljite jedinstveno zaglavlje Idempotency-Key.

Na ovoj stranici