Sammenlign direkte svar, Streaming, baggrundsopgaver og Webhooks. Alle varianter bruger tekst, sprogkoder og mode.
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
Endpunkt
POST /api/v2/translate
Bedst til
Kort tekst, hvis resultat er brugbart med det samme.
Succes
200 OK
Streaming
Svaret bruger Content-Type: text/event-stream.
Endpunkt
POST /api/v2/translate/stream
Bedst til
For længere indhold, hvis resultat skal vises trin for trin.
{
"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 begynder med meta, og derefter følger en eller flere tekstdele som delta.
Den første hændelse indeholder anmodnings-id, sprogkode og tilstand.
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. Brug den samme beskårne nøgle på 1 til 255 tegn ved nye forsøg. Den første oprettelse returnerer 202, mens en gentagelse returnerer 200.
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",
"expiresAt": "2026-09-03T12:00:00.000Z"
}{
"jobId": "job_poll_001",
"status": "completed",
"locale": "fr",
"mode": "simple-language",
"output": "Simplified content in French.",
"expiresAt": "2026-09-03T12:00:00.000Z"
}Jobs forbliver ledige i syv dage.
Et job bevæger sig gennem queued, processing, completed eller failed. Mislykkede job indeholder error.code. Svar ved oprettelse og status indeholder expiresAt.
Spørg status igen efter et sekund, og øg afstandet gradvist i længere behandling.
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 Simple8-Signature som t=<timestamp>,v1=<signature>. <timestamp> er et Unix-tidsstempel i sekunder. Signaturen er det hexadecimale resultat med små bogstaver af en HMAC SHA-256 over <timestamp>.<raw request body>.
Tjek underskriften mod den uændrede anmodning. Du vil se den hemmelige signeringsnøgle én gang, når du opretter slutpunktet.
Returner HTTP 200 eller 201, så snart dit system har accepteret hændelsen.
Gentagelser: Hvis der er en fejl, vil Simple8 forsøge at levere det igen i løbet af syv dage op til 50 gange. De sidste forsøg kan du se i applikationen.
Doppel hændelser: Forarbejd hver begivenhed ID kun én gang, da en gentagelse kan sende samme begivenhed igen.
Batchbehandling
Send mellem 1 og 50 genstande med et samlet maksimum på 25.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.
{
"items": [
{
"text": "First source text.",
"locale": "en",
"mode": "simple-language"
},
{
"text": "Second source text.",
"locale": "de",
"mode": "easy-language"
}
],
"delivery": {
"type": "polling"
}
}{
"batchId": "batch_001",
"status": "queued",
"itemCount": 2
}{
"batchId": "batch_001",
"status": "completed",
"itemCount": 2,
"items": [
{
"jobId": "job_001",
"status": "completed",
"locale": "en",
"mode": "simple-language",
"output": "First result."
},
{
"jobId": "job_002",
"status": "failed",
"locale": "de",
"mode": "easy-language",
"error": {
"code": "processing_failed"
}
}
]
}Oprettelse af en batch returnerer HTTP 202 første gang og HTTP 200 ved en idempotent gentagelse. Webhook-hændelserne er job.completed, job.failed, batch.completed og batch.failed. Fuldførte webhook-payloads indeholder kun identifikatorer og status. Hent output fra status-endpointet for jobbet eller batchen.