Dokumentaatio

Valitse, miten järjestelmäsi saa tuloksen.

{
  "text": "Monimutkainen lähdesisältö valitulla kielellä.",
  "locale": "fi",
  "mode": "simple-language"
}

SDK- ja cURL-esimerkkejä saatavilla

Synkroniinen HTTP

Jokainen kuvio käyttää samoja ydinkenttiä: teksti, alue ja tila.

Lopputulos

POST /api/v2/translate

Parasta

Lyhyt sisältö ja suorat taaksepääsytoiminnot.

Menestys

200 Hyvä on.

Lähetys

Vastaus käyttää Content-Type: text/event-stream.

Lopputulos

POST /api/v2/translate/stream

Parasta

Edistyvät käyttöliittymät ja pidempi sisältö.

{
  "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 lähettää yhden metatapahtuman, yhden tai useamman deltatapahtuman ja viimeisen valmiin tapahtuman.

Metatapahtuma sisältää pyynnön tunnisteen, kielialueen ja tilan.

Jokainen delta sisältää osan tuloksesta ja done sisältää käyttötiedot.

Kun olet valmis, yhteys sulkeutuu.

Asynkisointi työllä äänestys

Lähetä yksilöllinen Idempotency-Key-otsikko luodessasi työtä.

Luoda loppupiste

POST /api/v2/jobs

Tilanne päämäärä

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

Työpaikkoja on tarjolla seitsemän päivää.

Äänestys kohtuullisin välein, kunnes tila on valmis tai epäonnistuu.

Asynkisointi työ webhookin kanssa

Luo ja vahvista ensin webhook-päätepiste Simple8-sovelluksessa. Viittaa sitten sen päätepisteen tunnukseen työssä.

Luoda loppupiste

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 lähettää Simple8-Signature-otsikon aikaleimalla ja HMAC SHA-256 -allekirjoituksella.

Tarkista allekirjoitus raakapyynnön rungosta ja allekirjoitussalaisuus näytetään kerran päätepisteen luomisen yhteydessä.

Palauta mikä tahansa 2xx-tila tapahtuman hyväksymisen jälkeen.

Epäonnistuneita toimituksia yritetään uudelleen jopa 50 kertaa seitsemän päivän aikana, ja viimeisimmät yritykset näkyvät sovelluksessa.

Vastaanottajien on siedettävä päällekkäisiä toimituksia, koska uudelleenyritykset voivat toimittaa saman tapahtuman useammin kuin kerran.

Eräkäsittely

Lähetä 1–50 kohdetta, joissa on yhteensä enintään 500 000 merkkiä.

Luoda loppupiste

POST /api/v2/batches

Tilanne päämäärä

GET /api/v2/batches/{id}

Jokainen kohde käyttää samoja teksti-, alue- ja tilakenttiä synkronisena pyyntönä.

Valitse kysely tai vahvistettu webhook-päätepiste toimitettavaksi ja lähetä yksilöllinen Idempotency-Key-otsikko.

Tällä sivulla