Demo

Makkelijk lezen: Bekijk elke API-instelling in actie.

simple8 zet complexe content om in gestructureerde, makkelijk leesbare tekst voor mensen die extra taalondersteuning nodig hebben. Vergelijk duidelijke taal en makkelijk lezen, volledige en verkorte uitvoer, optionele kwaliteitshints en alle vier leveringspatronen met live verzoek- en antwoordvoorbeelden.

Makkelijk lezen

simple8 zet complexe content om in gestructureerde, makkelijk leesbare tekst voor mensen die extra taalondersteuning nodig hebben.

Duitse uitvoer volgens DIN

De uitvoer van simple8 in duidelijke Duitse taal voldoet aan DIN ISO 24495-1 en DIN 8581-1. De uitvoer in makkelijke Duitse taal voldoet aan DIN SPEC 33429.

CMS, API en websitewidget met één regel JavaScript

Integreer simple8 met WordPress, TYPO3, Drupal, Storyblok en vele andere systemen, koppel via de API of voeg de websitewidget toe met één regel JavaScript.

Volledig gehost in Duitsland

simple8 wordt volledig in Duitsland gehost en beheerd. Hosting en gegevensverwerking voldoen aan de AVG (GDPR).

SLA van 99,9% maandelijkse beschikbaarheid

simple8 biedt voor de productie-API een SLA van 99,9% maandelijkse beschikbaarheid.

Ga naar het architectuuroverzicht website-integratie

Interactief voorbeeld

Verzoek en antwoord veranderen bij elke instelling.

Hier kunt u direct zien hoe eenvoudig taalgebruik, eenvoudig taalgebruik, volledige of verkorte antwoorden en optionele kwaliteitsinformatie samenwerken.

Invoer

Brontekst en instellingen

Brontekst

261 / 1000 tekens

Modus

Detailniveau

KwaliteitsnotitiesVoegt aanvullende kwaliteitsinformatie toe aan het API-antwoord. Zonder deze instelling levert het antwoord alleen het resultaat op.

API-aanvraag

{
  "text": "Om de verwerking te versnellen, moeten gebruikers na een succesvolle registratie eerst hun persoonlijke gegevens controleren, deze indien nodig bijwerken en vervolgens het proces digitaal bevestigen. Na het indienen ontvang je een bericht met de vervolgstappen.",
  "locale": "nl",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Uitvoer

Makkelijk lezen

Voltooid940 ms

Na verzending verschijnt de gestreamde vertaling hier.

API-antwoord

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "nl",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Log in. Controleer uw gegevens. Verander valse informatie direct online. Bevestig het proces digitaal. U ontvangt dan een bericht. Het bericht bevat de volgende stappen."
  }
}

Vier API-architecturen

Alle vier de patronen lossen dezelfde technische taak op, maar met verschillende transportlogica.

De keuze hangt af van de vraag of het resultaat onmiddellijk nodig is, of de voortgang zichtbaar moet zijn en of het oproepende systeem actief kan wachten, pollen of via een gebeurtenis op de hoogte kan worden gesteld.

Synchronisch HTTP-verzoek

Er komt een verzoek binnen en het voltooide antwoord komt terug in dezelfde HTTP-verbinding.

Geschikt voor

Directe acties in de gebruikersinterface, korte teksten en lage latentie

Eén verzoek + streamingantwoord

Een verzoek wordt verwerkt, het antwoord komt stap voor stap terug als een stream.

Geschikt voor

Langere inhoud, progressieve gebruikersinterface, zichtbare verwerkingsvoortgang

Asynchrone taak + polling

Bij de eerste aanvraag wordt een taak aangemaakt, waarna de client herhaaldelijk de status opvraagt.

Geschikt voor

Batchverwerking, backends, langere taken zonder een aanhoudende open verbinding

Asynchrone taak + webhook

De eerste aanvraag creëert een taak, het voltooiingsbericht komt later terug via een webhook.

Geschikt voor

CMS-workflows, evenementenarchitectuur, betrouwbare systeem-naar-systeem-integratie

De vier patronen

Concept, technische implementatie en concrete voorbeelden voor elke architectuur.

Synchronisch HTTP-verzoek

Er komt een verzoek binnen en het voltooide antwoord komt terug in dezelfde HTTP-verbinding.

Uitvoer API

Het oproepende systeem verzendt een verzoek en wacht actief op het resultaat. `mode` en `settings` worden in hetzelfde verzoek doorgegeven en bepalen rechtstreeks de vorm van het antwoord.

We sturen individuele formulierteksten rechtstreeks naar simple8 en ontvangen onmiddellijk de juiste taalversie voor de geselecteerde modus.

API

Een `POST /api/translate` met tekst, taalmodus en instellingen is typisch.
Indien succesvol, retourneert de API direct `200 OK` met de vereenvoudigde tekst.
Als `qualityHints=false`, bevat het antwoord geen aanvullende kwaliteitshints.

POST /api/translate
{
  "text": "Für die Beantragung des Personalausweises bringen Sie bitte Ihren alten Ausweis oder Reisepass sowie ein aktuelles Lichtbild mit.",
  "mode": "simple-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

200 OK
{
  "requestId": "req_sync_001",
  "cacheStatus": "miss",
  "durationMs": 980,
  "mode": "simple-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Wenn Sie einen Personalausweis beantragen, bringen Sie bitte Ihren alten Ausweis oder Reisepass und ein aktuelles Foto mit."
  }
}

Eén verzoek + streamingantwoord

Een verzoek wordt verwerkt, het antwoord komt stap voor stap terug als een stream.

Uitvoer API

De cliënt start slechts één verzoek, maar blijft niet blind tot het einde. In plaats van een enkel definitief antwoord ontvangen ze via dezelfde verbinding voortdurende status- of inhoudsupdates.

Onze redactie moet zien welke versie momenteel wordt gemaakt en indien nodig onmiddellijk de kwaliteitsinformatie ontvangen.

API

Het verzoek bevat dezelfde technische opties als in het synchrone patroon: `mode`, `rewriteScope` en optioneel `qualityHints`.
De client verwerkt gebeurtenissen zoals `status`, `delta` en `completed` zonder nieuwe verzoeken uit te geven.
Als `qualityHints` actief is, kan het laatste bericht `completed` extra kwaliteitsaanwijzingen bevatten.

POST /api/translate/stream
{
  "text": "Nach der Beantragung des Personalausweises erhalten Sie ein Schreiben, sobald das Dokument in der Behörde zur Abholung bereitliegt.",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": true
  }
}

event: status
data: {"state":"processing","mode":"easy-language"}

event: delta
data: {"chunk":"Nach dem Antrag bekommen Sie ein Schreiben.\n"}

event: delta
data: {"chunk":"Dann wissen Sie: Ihr Ausweis liegt bereit.\n"}

event: completed
data: {
  "requestId": "req_stream_001",
  "cacheStatus": "miss",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": true
  },
  "output": {
    "text": "Nach dem Antrag bekommen Sie ein Schreiben.\nDann wissen Sie: Ihr Ausweis liegt bereit.",
    "qualityHints": [
      "Die Ausgabe nutzt sehr kurze Sätze mit klarer Reihenfolge."
    ]
  }
}

Asynchrone taak + polling

Bij de eerste aanvraag wordt een taak aangemaakt, waarna de client herhaaldelijk de status opvraagt.

Uitvoer API

De daadwerkelijke verwerking wordt losgekoppeld van de eerste HTTP-aanroep. Het oproepende systeem ontvangt onmiddellijk een taak-ID en controleert zichzelf later wanneer het opnieuw de status opvraagt.

Onze backend verzamelt veel teksten en vraagt later specifiek welke modusvariant klaar is.

API

Een `POST` creëert een taak en slaat de geselecteerde combinatie van modus en instellingen op.
De client vraagt 'GET /api/jobs/{id}' met tussenpozen totdat 'queued', 'running', 'completed' of 'failed' wordt gerapporteerd.
Polling is zeer geschikt wanneer gecomprimeerde of geanalyseerde versies worden geclassificeerd in grotere batchstromen.

POST /api/jobs
{
  "text": "Für die Beantragung des Personalausweises müssen Sie persönlich im Bürgeramt vorsprechen. Minderjährige brauchen die Zustimmung der Sorgeberechtigten.",
  "mode": "simple-language",
  "settings": {
    "rewriteScope": "condensed",
    "qualityHints": true
  }
}

202 Accepted
{
  "jobId": "job_poll_001",
  "status": "queued"
}

GET /api/jobs/job_poll_001
{
  "jobId": "job_poll_001",
  "status": "completed",
  "mode": "simple-language",
  "settings": {
    "rewriteScope": "condensed",
    "qualityHints": true
  },
  "output": {
    "text": "Für den Personalausweis müssen Sie persönlich ins Bürgeramt gehen.",
    "qualityHints": [
      "Die Ausgabe konzentriert sich auf die wichtigsten Aussagen und lässt Nebendetails weg."
    ]
  }
}

Asynchrone taak + webhook

De eerste aanvraag creëert een taak, het voltooiingsbericht komt later terug via een webhook.

Uitvoer API

Ook hier wordt de verwerking asynchroon gestart. In tegenstelling tot polling vraagt de client niet herhaaldelijk naar de status, maar wordt hij actief geïnformeerd zodra er een resultaat of fout beschikbaar is.

Ons CMS bepaalt voor elke inhoud of er eenvoudig taalgebruik of eenvoudig taalgebruik wordt gebruikt en slaat pas de voltooide versie op na de webhook.

API

Naast de technische gegevens verzendt het startverzoek ook de modus, instellingen en `webhookUrl`.
Na voltooiing verzendt de API een ondertekende `POST`-gebeurtenis naar het doelsysteem.
Webhookstromen zijn vooral handig bij het invoeren van verschillende uitvoermodi in publicatie- of releaseprocessen.

POST /api/jobs
{
  "text": "Wenn Sie Ihren Personalausweis beantragen, können Gebühren anfallen. Bitte bringen Sie die erforderlichen Unterlagen vollständig zum Termin mit.",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "condensed",
    "qualityHints": false
  },
  "webhookUrl": "https://cms.example.com/webhooks/simple8"
}

202 Accepted
{
  "jobId": "job_hook_001",
  "status": "queued"
}

POST https://cms.example.com/webhooks/simple8
simple8-signature: sha256=...

{
  "event": "job.completed",
  "jobId": "job_hook_001",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "condensed",
    "qualityHints": false
  },
  "output": {
    "text": "Für den Personalausweis können Gebühren anfallen.\nBringen Sie bitte alle nötigen Unterlagen mit."
  }
}