Dokumentation

Vælg, hvordan dit system modtager resultatet.

{
  "text": "Kompleks kildeindhold på det valgte sprog.",
  "locale": "da",
  "mode": "simple-language"
}

Eksempler på SDK og cURL tilgængelige

Synkron HTTP

Hvert mønster bruger de samme kernefelter: tekst, lokalitet og tilstand.

Endpunkt

POST /api/v2/translate

Bedst til

Kort indhold og direkte backend-handlinger.

Succes

200 OK

Streaming

Svaret bruger Content-Type: text/event-stream.

Endpunkt

POST /api/v2/translate/stream

Bedst til

Progressive grænseflader og længere indhold.

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

Streamen udsender én metahændelse, en eller flere deltahændelser og en afsluttende hændelse.

Metahændelsen indeholder anmodnings-id'en, landestandarden og tilstanden.

Hver delta indeholder en del af resultatet, og færdig indeholder brugsoplysningerne.

Når det er gjort, lukker forbindelsen.

Asynchroniseret arbejde med meningsmålinger

Send en unik Idempotency-Key header, når du opretter et job.

Oprette slutpunkt

POST /api/v2/jobs

Status-endpoint

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

Jobs forbliver ledige i syv dage.

Afstemning med et rimeligt interval, indtil status er fuldført eller mislykket.

Asynchroniseringsarbejde med webhook

Opret og bekræft først et webhook-slutpunkt i Simple8-applikationen. Referer derefter til dets slutpunkt-id i jobbet.

Oprette 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 sender en Simple8-Signatur-header med et tidsstempel og en HMAC SHA-256-signatur.

Bekræft signaturen mod den rå anmodningstekst med signeringshemmeligheden vist én gang, når slutpunktet er oprettet.

Returner enhver 2xx-status efter accept af begivenheden.

Mislykkede leverancer prøves igen op til 50 gange over syv dage, og de seneste forsøg er synlige i applikationen.

Modtagere skal tolerere duplikatlevering, fordi genforsøg kan levere den samme hændelse mere end én gang.

Batchbehandling

Send mellem 1 og 50 genstande med et samlet maksimum på 500.000 tegn.

Oprette slutpunkt

POST /api/v2/batches

Status-endpoint

GET /api/v2/batches/{id}

Hvert element bruger de samme tekst-, landestandard- og tilstandsfelter som en synkron anmodning.

Vælg polling eller et verificeret webhook-slutpunkt til levering, og send en unik Idempotency-Key-header.

På denne side