Dokumentation

Välj hur ditt system får resultatet.

{
  "text": "Komplext källinnehåll på det valda språket.",
  "locale": "sv",
  "mode": "simple-language"
}

SDK- och cURL-exempel tillgängliga

Synkront HTTP

Varje mönster använder samma kärnfält: text, språk och läge.

Slutpunkt

POST /api/v2/translate

Bäst för

Kort innehåll och direkt baklängd.

Framgång

200 OK

Streaming

Svaret använder Content-Type: text/event-stream.

Slutpunkt

POST /api/v2/translate/stream

Bäst för

Progressiva gränssnitt och längre innehåll.

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

Strömmen sänder ut en metahändelse, en eller flera deltahändelser och en slutlig genomförd händelse.

Metahändelsen innehåller förfrågningsidentifieraren, språkinställningen och läget.

Varje delta innehåller en del av resultatet och gjort innehåller användningsinformationen.

Efter det stänger anslutningen.

Asynchroniserad arbetsplats med val

Skicka en unik Idempotency-Key header när du skapar ett jobb.

Skapa slutpunkt

POST /api/v2/jobs

Slutpunkt för status

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

Jobben finns kvar i sju dagar.

Polla med ett rimligt intervall tills statusen är klar eller misslyckad.

Asynchroniseringsarbete med webhook

Skapa och verifiera en webhook-slutpunkt i Simple8-applikationen först. Referera sedan till dess slutpunkts-ID i jobbet.

Skapa slutpunkt

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 skickar en Simple8-Signatur-huvud med en tidsstämpel och en HMAC SHA-256-signatur.

Verifiera signaturen mot råbegäran med signeringshemligheten som visas en gång när slutpunkten skapas.

Returnera eventuell 2xx-status efter att ha accepterat händelsen.

Misslyckade leveranser prövas igen upp till 50 gånger under sju dagar, och de senaste försöken syns i applikationen.

Mottagare måste tolerera dubbla leveranser eftersom återförsök kan leverera samma händelse mer än en gång.

Batchbearbetning

Skicka mellan 1 och 50 objekt med sammanlagt max 500 000 tecken.

Skapa slutpunkt

POST /api/v2/batches

Slutpunkt för status

GET /api/v2/batches/{id}

Varje objekt använder samma text-, språk- och lägesfält som en synkron begäran.

Välj polling eller en verifierad webhook-slutpunkt för leverans och skicka ett unikt Idempotency-Key-huvud.

På den här sidan