Demo

Lättläst svenska: Se alla API-inställningar i aktion.

simple8 omvandlar komplext innehåll till strukturerad lättläst svenska för personer som behöver starkare språkligt stöd. Jämför klarspråk och lättläst svenska, komplett och komprimerad utdata, valfria kvalitetstips och alla fyra leveransmönster med liveförfrågningar och svarsexempel.

Lättläst svenska

simple8 omvandlar komplext innehåll till strukturerad lättläst svenska för personer som behöver starkare språkligt stöd.

Tyska resultat som uppfyller DIN-standarderna

simple8s resultat på tyskt klarspråk uppfyller DIN ISO 24495-1 och DIN 8581-1. Resultat på tysk lättläst text uppfyller DIN SPEC 33429.

CMS, API och webbplatswidget med en rad JavaScript

Integrera simple8 med WordPress, TYPO3, Drupal, Storyblok och många fler system, anslut via API:t eller lägg till webbplatswidgeten med en rad JavaScript.

Hosting helt i Tyskland

simple8 hostas och drivs helt i Tyskland. Hosting och databehandling följer GDPR.

SLA med 99,9 % tillgänglighet per månad

simple8 tillhandahåller ett SLA med 99,9 % tillgänglighet per månad för produktions-API:t.

Hoppa till arkitekturöversikten webbplatsintegration

Interaktivt exempel

Begäran och svar ändras med varje inställning.

Här kan du direkt se hur enkelt språk, enkelt språk, fullständiga eller sammanfattade svar och valfri kvalitetsinformation samverkar.

Indata

Källtext och inställningar

Källtext

246 / 1000 tecken

Läge

Detaljnivå

KvalitetsanmärkningarLägger till ytterligare kvalitetsinformation till API-svaret. Utan denna inställning ger svaret bara resultatet.

API-begäran

{
  "text": "För att påskynda behandlingen måste användare först kontrollera sin personliga information efter framgångsrik registrering, uppdatera den vid behov och sedan bekräfta processen digitalt. När du har skickat in får du ett meddelande med nästa steg.",
  "locale": "sv",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Utdata

Lättläst svenska

Slutförd940 ms

Efter sändning kommer den streamade översättningen att visas här.

API-svar

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "sv",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Logga in. Kontrollera din information. Ändra falsk information direkt online. Bekräfta processen digitalt. Du får då ett meddelande. Meddelandet innehåller nästa steg."
  }
}

Fyra API-arkitekturer

Alla fyra mönstren löser samma tekniska uppgift, men med olika transportlogik.

Valet beror på om resultatet behövs omedelbart, om framstegen ska vara synliga och om det anropande systemet aktivt kan vänta, polla eller meddelas via händelse.

Synkron HTTP-begäran

En begäran går in och det färdiga svaret kommer tillbaka i samma HTTP-anslutning.

Lämplig för

Direkta åtgärder i användargränssnittet, korta texter och låg latens

En begäran + strömmande svar

En begäran börjar bearbetas, svaret kommer tillbaka steg för steg som en ström.

Lämplig för

Längre innehåll, progressivt användargränssnitt, synliga bearbetningsförlopp

Asynkroniserat jobb + polling

Den första begäran skapar ett jobb, sedan frågar klienten om statusen upprepade gånger.

Lämplig för

Batchbearbetning, backends, längre jobb utan en ihållande öppen anslutning

Asynkroniserat jobb + webhook

Den första begäran skapar ett jobb, meddelandet om slutförande kommer tillbaka senare via en webhook.

Lämplig för

CMS-arbetsflöden, händelsearkitektur, pålitlig system-till-system-integration

De fyra mönstren

Koncept, teknisk implementering och konkreta exempel för varje arkitektur.

Synkron HTTP-begäran

En begäran går in och det färdiga svaret kommer tillbaka i samma HTTP-anslutning.

Utdata API

Det anropande systemet skickar en begäran och väntar aktivt på resultatet. `mode` och `settings` skickas i samma begäran och styr svarets form direkt.

Vi skickar individuella formulärtexter direkt till simple8 och får omedelbart rätt språkversion för det valda läget.

API

En `POST /api/translate` med text, språkläge och inställningar är typiskt.
Om det lyckas returnerar API direkt "200 OK" med den förenklade texten.
Om 'qualityHints=false' innehåller svaret inga ytterligare kvalitetstips.

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

En begäran + strömmande svar

En begäran börjar bearbetas, svaret kommer tillbaka steg för steg som en ström.

Utdata API

Klienten startar bara en begäran, men förblir inte blind till slutet. Istället för ett enda slutligt svar får de pågående status- eller innehållsuppdateringar över samma anslutning.

Vår redaktion bör se vilken version som för närvarande skapas och vid behov omedelbart få kvalitetsinformationen.

API

Begäran innehåller samma tekniska alternativ som i det synkrona mönstret: `mode`, `rewriteScope` och valfritt `qualityHints`.
Klienten bearbetar händelser som `status`, `delta` och `completed` utan att utfärda nya förfrågningar.
När `qualityHints` är aktivt kan det slutliga meddelandet `completed` innehålla ytterligare kvalitetskommentarer.

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

Asynkroniserat jobb + polling

Den första begäran skapar ett jobb, sedan frågar klienten om statusen upprepade gånger.

Utdata API

Den faktiska behandlingen är frikopplad från det första HTTP-anropet. Det anropande systemet får omedelbart ett jobb-ID och kontrollerar sig senare när det frågar efter status igen.

Vår backend samlar in många texter och frågar senare specifikt vilken lägesvariant som är klar.

API

Ett "POST" skapar ett jobb och sparar den valda kombinationen av läge och inställningar.
Klienten anropar `GET /api/jobs/{id}` med jämna mellanrum tills statusen `queued`, `running`, `completed` eller `failed` rapporteras.
Polling lämpar sig väl när kondenserade eller analyserade versioner klassificeras i större batchflöden.

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

Asynkroniserat jobb + webhook

Den första begäran skapar ett jobb, meddelandet om slutförande kommer tillbaka senare via en webhook.

Utdata API

Även här startas bearbetningen asynkront. Till skillnad från polling, frågar inte klienten statusen upprepade gånger, utan aviseras aktivt så snart ett resultat eller fel är tillgängligt.

Vårt CMS bestämmer för varje innehåll om enkelt språk eller enkelt språk används och sparar först den färdiga versionen efter webhook.

API

Förutom tekniska data överför startförfrågan även läge, inställningar och `webhookUrl`.
När det är klart skickar API:et en signerad "POST"-händelse till målsystemet.
Webhook-flöden är särskilt användbara när olika utdatalägen matas in i publicerings- eller releaseprocesser.

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