Vergelijk directe antwoorden, streaming, achtergrondtaken en webhooks. Alle varianten gebruiken tekst, taalcode en modus.
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
Eindpunt
POST /api/v2/translate
Het beste voor
Korte teksten, waarvan het resultaat onmiddellijk nodig is.
Succes
200 Goed
Streaming
Het antwoord maakt gebruik van Content-Type: text/event-stream.
Eindpunt
POST /api/v2/translate/stream
Het beste voor
Voor langere inhoud, waarvan het resultaat geleidelijk moet worden weergegeven.
{
"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 stroom begint met Meta. Dit wordt gevolgd door een of meer delen van de tekst als delta. De voltooide gebeurtenis vult het antwoord aan met de gebruiksgegevens.
De eerste gebeurtenis bevat het verzoek ID, de spraakcode en de 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
Idempotency-Key voorkomt dubbele taken als u een verzoek opnieuw verstuurt na een time-out of verbindingsfout. Kies voor elke nieuwe taak een nieuwe sleutel, bijvoorbeeld een UUID. U maakt deze verzoekidentificatie zelf; dit is niet uw API-sleutel.
Skep endpoint
POST /api/v2/jobs
Status eindpunt
GET /api/v2/jobs/{id}
Gebruik 1 tot 255 tekens: A-Z, a-z, 0-9, punten (.), underscores (_), dubbele punten (:) of koppeltekens (-). Gebruik geen spaties en kort de sleutel niet in. Verstuur bij elke herhaling dezelfde sleutel en dezelfde verzoekinhoud.
De eerste aanmaak geeft HTTP 202 terug. Hetzelfde verzoek herhalen geeft HTTP 200 met de bestaande taak-ID terug. Dezelfde sleutel met een ander verzoek geeft HTTP 409 terug. Deze regels gelden ook voor batches. De onderstaande voorbeelden bevatten de header; vervang elke voorbeeldsleutel eenmaal per nieuwe taak of batch.
curl https://api.simple8.de/api/v2/jobs \
-H "Authorization: Bearer $SIMPLE8_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: article-4711-v1" \
-d '{
"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"
}Vacatures blijven zeven dagen beschikbaar.
Een taak doorloopt queued, processing, completed of failed. Mislukte taken bevatten error.code. Aanmaak- en statusreacties bevatten expiresAt.
Vraag eerst na één seconde opnieuw om de status. Verhoog de afstand geleidelijk met langere verwerking.
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
curl https://api.simple8.de/api/v2/jobs \
-H "Authorization: Bearer $SIMPLE8_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: article-4711-webhook-v1" \
-d '{
"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 Simple8-Signature als t=<timestamp>,v1=<signature>. <timestamp> is een Unix-tijdstempel in seconden. De handtekening is de hexadecimale uitvoer in kleine letters van een HMAC SHA-256 over <timestamp>.<raw request body>.
Controleer de handtekening tegen het ongewijzigde verzoek. U ziet de geheime handtekening sleutel zodra u het eindpunt.
Retourneer HTTP 200 of 201 zodra je systeem de gebeurtenis accepteert.
Herhaalt: In het geval van een fout, Simple8 probeert levering tot 50 keer binnen zeven dagen. Je kunt de laatste pogingen in de toepassing zien.
Gebeurtenissen dupliceren: Bewerk elke gebeurtenis-ID slechts één keer, omdat een herhaling dezelfde gebeurtenis opnieuw kan verzenden.
Batchverwerking
Verzend tussen 1 en 50 items met een gecombineerd maximum van 25.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.
curl https://api.simple8.de/api/v2/batches \
-H "Authorization: Bearer $SIMPLE8_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: release-4711-v1" \
-d '{
"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"
}
}
]
}Het aanmaken van een batch retourneert de eerste keer HTTP 202 en bij een idempotente herhaling HTTP 200. De webhookgebeurtenissen zijn job.completed, job.failed, batch.completed en batch.failed. Payloads van voltooide webhooks bevatten alleen identificatoren en status. Haal de uitvoer op via het status-endpoint van de taak of batch.