Dokumentáció

Válasszon, hogy a rendszered hogyan kapja a hatást.

{
  "text": "Összetett forrástartalom a kiválasztott nyelven.",
  "locale": "hu",
  "mode": "simple-language"
}

SDK- és cURL-példák állnak rendelkezésre

Hirtelen

Minden minta ugyanazokat az alapvető mezőket használja: szöveg, területi beállítás és mód.

Végpont

POST /api/v2/translate

A legjobb a

Rövid tartalom és közvetlen háttérbevonás.

Siker

200 Rendben.

Szenvedés

A válasz a Content-Type: text/event-stream értéket használja.

Végpont

POST /api/v2/translate/stream

A legjobb a

Progresszív felületek és hosszabb tartalom.

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

Az adatfolyam egy metaeseményt, egy vagy több delta eseményt és egy végső kész eseményt bocsát ki.

A metaesemény tartalmazza a kérésazonosítót, a területi beállítást és a módot.

Minden delta tartalmazza az eredmény egy részét, a kész pedig a használati információkat tartalmazza.

Miután elkészült, a kapcsolat megszakad.

A szavazással szinkronizált munka

Egyedi Idempotency-Key fejléc küldése munka létrehozásakor.

Készítsen végpontot

POST /api/v2/jobs

A helyzet végpontja

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

Az állások hét napig állnak rendelkezésre.

Szavazás ésszerű időközönként, amíg az állapot befejeződik vagy meghiúsul.

Asynchronizált munka webhook

Először hozzon létre és ellenőrizze egy webhook-végpontot az Simple8 alkalmazásban. Ezután hivatkozzon a végpont azonosítójára a jobban.

Készítsen végpontot

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

Az Simple8 egy Simple8-Signature fejlécet küld időbélyeggel és egy HMAC SHA-256 aláírással.

Ellenőrizze az aláírást a nyers kérés törzséhez képest az aláírási titokkal, amely egyszer megjelenik a végpont létrehozásakor.

Bármilyen 2xx állapot visszaállítása az esemény elfogadása után.

A sikertelen kézbesítéseket hét nap alatt legfeljebb 50 alkalommal próbálják meg újra, és a legutóbbi próbálkozások láthatók az alkalmazásban.

A címzetteknek el kell viselniük a duplikált kézbesítést, mivel az újrapróbálkozások többször is kézbesíthetik ugyanazt az eseményt.

Kötegelt feldolgozás

1 és 50 közötti tételt küldhet, összesen legfeljebb 500 000 karakterből.

Készítsen végpontot

POST /api/v2/batches

A helyzet végpontja

GET /api/v2/batches/{id}

Minden elem ugyanazt a szöveg-, terület- és módmezőt használja szinkron kérésként.

Válasszon lekérdezést vagy egy ellenőrzött webhook-végpontot a kézbesítéshez, és küldjön egyedi Idempotency-Key fejlécet.

Ezen az oldalon