Dokumentacija

Izberite, kako vaš sistem prejme rezultat.

{
  "text": "Kompleksna izvorna vsebina v izbranem jeziku.",
  "locale": "sl",
  "mode": "simple-language"
}

Na voljo so primeri SDK in cURL

Sinkronni HTTP

Vsak vzorec uporablja ista osnovna polja: besedilo, jezik in način.

Končna točka

POST /api/v2/translate

Najboljša za

Kratka vsebina in neposredna akcija v ozadju.

Uspeh

200 v redu.

Streaming

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

Končna točka

POST /api/v2/translate/stream

Najboljša za

Progresivni vmesniki in daljša vsebina.

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

Tok oddaja en metadogodek, enega ali več delta dogodkov in končni dogodek.

Meta dogodek vsebuje identifikator zahteve, jezik in način.

Vsak delta vsebuje del rezultata in done vsebuje informacije o uporabi.

Po končanem se povezava prekine.

Neodveden delovni čas z anketajo

Pri ustvarjanju opravila pošljite edinstveno glavo Idempotency-Key.

Ustvarjanje končne točke

POST /api/v2/jobs

Končna točka stanja

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

Delovna mesta ostanejo na voljo sedem dni.

Anketirajte v razumnih intervalih, dokler stanje ni dokončano ali neuspešno.

Async delo z webhook

Najprej ustvarite in preverite končno točko webhook v aplikaciji Simple8. Nato se v opravilu sklicujte na njegov ID končne točke.

Ustvarjanje končne točke

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 pošlje glavo Simple8-Signature s časovnim žigom in podpisom HMAC SHA-256.

Preverite podpis glede na neobdelano telo zahteve s skrivnostjo podpisovanja, prikazano enkrat, ko je ustvarjena končna točka.

Po sprejemu dogodka vrnite kateri koli status 2xx.

Neuspele dostave se poskusijo do 50-krat v sedmih dneh, zadnji poskusi pa so vidni v aplikaciji.

Prejemniki morajo dopustiti podvojeno dostavo, ker lahko ponovni poskusi dostavijo isti dogodek več kot enkrat.

Paketna obdelava

Pošljite od 1 do 50 elementov s skupno največ 500.000 znaki.

Ustvarjanje končne točke

POST /api/v2/batches

Končna točka stanja

GET /api/v2/batches/{id}

Vsak element uporablja isto besedilo, področne nastavitve in polja načina kot sinhrona zahteva.

Za dostavo izberite anketiranje ali preverjeno končno točko webhook in pošljite edinstveno glavo Idempotency-Key.

Na tej strani