Documentatie

Kies hoe je systeem het resultaat ontvangt.

{
  "text": "Complexe broninhoud in de geselecteerde taal.",
  "locale": "nl",
  "mode": "simple-language"
}

SDK- en cURL-voorbeelden beschikbaar

Synchrone HTTP

Elk patroon gebruikt dezelfde kernvelden: tekst, landinstelling en modus.

Eindpunt

POST /api/v2/translate

Het beste voor

Kort inhoud en directe back-end acties.

Succes

200 Goed

Streaming

Het antwoord maakt gebruik van Content-Type: text/event-stream.

Eindpunt

POST /api/v2/translate/stream

Het beste voor

Progressieve interfaces en langere inhoud.

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

De stream verzendt één meta-gebeurtenis, een of meer delta-gebeurtenissen en een uiteindelijke voltooide gebeurtenis.

De meta-gebeurtenis bevat de aanvraag-ID, landinstelling en modus.

Elke delta bevat een deel van het resultaat en done bevat de gebruiksinformatie.

Als u klaar bent, wordt de verbinding gesloten.

Asynchrone werk met polling

Stuur een unieke Idempotency-Key-header bij het maken van een taak.

Skep endpoint

POST /api/v2/jobs

Status eindpunt

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

Vacatures blijven zeven dagen beschikbaar.

Poll met een redelijk interval totdat de status voltooid of mislukt is.

Asynchronisatie met webhook

Maak en verifieer eerst een webhookeindpunt in de Simple8-applicatie. Verwijs vervolgens naar de eindpunt-ID in de taak.

Skep endpoint

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 verzendt een Simple8-Signature-header met een tijdstempel en een HMAC SHA-256-handtekening.

Controleer de handtekening aan de hand van de onbewerkte aanvraagtekst, waarbij het ondertekeningsgeheim één keer wordt weergegeven wanneer het eindpunt wordt gemaakt.

Retourneer een eventuele 2xx-status na acceptatie van de gebeurtenis.

Mislukte leveringen worden gedurende zeven dagen tot 50 keer opnieuw geprobeerd en recente pogingen zijn zichtbaar in de applicatie.

Ontvangers moeten dubbele bezorging tolereren, omdat nieuwe pogingen dezelfde gebeurtenis meer dan één keer kunnen opleveren.

Batchverwerking

Verzend tussen 1 en 50 items met een gecombineerd maximum van 500.000 tekens.

Skep endpoint

POST /api/v2/batches

Status eindpunt

GET /api/v2/batches/{id}

Elk item gebruikt dezelfde tekst-, landinstelling- en modusvelden als een synchrone aanvraag.

Kies polling of een geverifieerd webhook-eindpunt voor levering en stuur een unieke Idempotency-Key-header.

Op deze pagina