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

Primjeri direktne odgovore, Streaming, pozadinske zadatke i Webhooks. Sve varijante koriste tekst, jezikovnu kod i način.

Svrha

POST /api/v2/translate

Najbolje za

Kratki tekstovi koji će odmah biti potrebni.

Uspjeh

200 OK

Streaming

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

Svrha

POST /api/v2/translate/stream

Najbolje za

Za dulji sadržaj, čiji rezultat treba prikazati korak po korak.

{
  "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 počinje meta. Zatim slijedi jedan ili više dijelova teksta kao delta. Dogodak done završava odgovor s podacima o upotrebi.

Prvi događaj sadrži ID zahtjeva, šifru jezika 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. Za ponovne pokušaje upotrijebite isti ključ bez početnih i završnih razmaka, duljine od 1 do 255 znakova. Prvo stvaranje vraća 202, a ponovljeni zahtjev vraća 200.

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

Posao ostaje dostupan sedam dana.

Zadatak prolazi kroz stanja queued, processing, completed ili failed. Neuspjeli zadaci sadrže error.code. Odgovori za stvaranje i stanje sadrže expiresAt.

Prvo, nakon sekunde ponovno postavljajte pitanje o stanju.

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 Simple8-Signature u obliku t=<timestamp>,v1=<signature>. <timestamp> je Unix vremenska oznaka u sekundama. Potpis je heksadecimalni rezultat HMAC-a SHA-256 nad <timestamp>.<raw request body>, zapisan malim slovima.

Provjerite potpis protiv nepromijenjenog zahtjeva. Tajni ključ za potpisivanje vidjet ćete jednom prilikom izrade krajnje točke.

Vratite HTTP 200 ili 201 čim vaš sustav prihvati događaj.

Ponavljanje: Ako se nešto pogreši, Simple8 će se isporučiti do 50 puta u roku od sedam dana.

Dvostruki događaji: Prerađujte svaki ID događaja samo jednom, jer ponavljanje može ponovno poslati istu događaj.

Skupna obrada

Pošaljite između 1 i 50 stavki s kombiniranim maksimalno 25.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.

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

Stvaranje serije prvi put vraća HTTP 202, a pri idempotentnom ponavljanju HTTP 200. Webhook događaji su job.completed, job.failed, batch.completed i batch.failed. Payloadi dovršenih webhookova sadrže samo identifikatore i stanje. Dohvatite endpoint stanja zadatka ili serije da biste pročitali rezultat.

Na ovoj stranici

Izberite kako vaš sustav prima rezultat.

Počnite besplatno koristiti Simple8.