Dokumentatsioon

Vali, kuidas teie süsteem saab tulemust.

{
  "text": "Keeruline lähtesisu valitud keeles.",
  "locale": "et",
  "mode": "simple-language"
}

Saadaval on SDK ja cURL-i näited

Sinkroonne HTTP

Iga muster kasutab samu põhivälju: tekst, lokaat ja režiim.

Lõpppunkt

POST /api/v2/translate

Parim, kui

Lühe sisu ja otsesed tagasilöökide tegurid.

Edu

200 Olgu.

Sorrutus

Vastus kasutab sisutüüpi: text/event-stream.

Lõpppunkt

POST /api/v2/translate/stream

Parim, kui

Progressiivsed liidud ja pikem sisu.

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

Voog väljastab ühe metasündmuse, ühe või mitu deltasündmust ja lõpliku tehtud sündmuse.

Metasündmus sisaldab päringu identifikaatorit, lokaati ja režiimi.

Iga delta sisaldab osa tulemusest ja tehtud sisaldab kasutusteavet.

Pärast lõpetamist ühendus sulgub.

Asynchronootiv töö valimistega

Saatke töö loomisel unikaalne Idempotency-Key päis.

Looda lõpppunkt

POST /api/v2/jobs

Status lõpppunkt

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

Tööd on saadaval seitse päeva.

Küsitlus mõistliku intervalliga, kuni olek on lõpetatud või nurjunud.

Asynchronoo tööga webhookiga

Esmalt looge ja kinnitage veebihaagi lõpp-punkt rakenduses Simple8. Seejärel viidake selle lõpp-punkti ID-le töös.

Looda lõpppunkt

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 saadab ajatempli ja HMAC SHA-256 allkirjaga päise Simple8-Signature.

Kontrollige allkirja töötlemata päringu keha suhtes koos allkirjastamise saladusega, mis kuvatakse üks kord lõpp-punkti loomisel.

Pärast sündmusega nõustumist tagastage mis tahes 2xx olek.

Ebaõnnestunud tarneid proovitakse seitsme päeva jooksul uuesti kuni 50 korda ja viimased katsed on rakenduses nähtavad.

Vastuvõtjad peavad taluma topeltedastust, sest korduskatsed võivad sama sündmuse edastada mitu korda.

Partii töötlemine

Saatke 1 kuni 50 üksust maksimaalselt 500 000 tähemärgiga.

Looda lõpppunkt

POST /api/v2/batches

Status lõpppunkt

GET /api/v2/batches/{id}

Iga üksus kasutab sünkroonse päringuna samu teksti-, lokaadi- ja režiimivälju.

Valige edastamiseks küsitlus või kinnitatud veebihaagi lõpp-punkt ja saatke kordumatu Idempotency-Key päis.

Sellel lehel