Demo

Ľahko čitateľný jazyk: Pozrite si každé nastavenie API v akcii.

simple8 prevádza zložitý obsah do štruktúrovaného a ľahko čitateľného jazyka pre ľudí, ktorí potrebujú silnejšiu jazykovú podporu. Porovnajte zrozumiteľný jazyk a ľahko čitateľný jazyk, kompletný a zhustený výstup, voliteľné rady týkajúce sa kvality a všetky štyri vzory doručenia so živými príkladmi požiadaviek a reakcií.

Ľahko čitateľný jazyk

simple8 prevádza zložitý obsah do štruktúrovaného a ľahko čitateľného jazyka pre ľudí, ktorí potrebujú silnejšiu jazykovú podporu.

Nemecké výstupy v súlade s DIN

Výstupy simple8 v zrozumiteľnej nemčine sú v súlade s DIN ISO 24495-1 a DIN 8581-1. Výstupy v ľahko čitateľnej nemčine sú v súlade s DIN SPEC 33429.

CMS, API a webový widget s jedným riadkom JavaScriptu

Integrujte simple8 so systémami WordPress, TYPO3, Drupal a Storyblok a mnohými ďalšími systémami, pripojte ho cez API alebo pridajte webový widget jedným riadkom JavaScriptu.

Hosting výhradne v Nemecku

simple8 je kompletne hostovaný a prevádzkovaný v Nemecku. Hosting a spracovanie údajov sú v súlade s GDPR.

SLA s mesačnou dostupnosťou 99,9 %

simple8 poskytuje pre produkčné API SLA s mesačnou dostupnosťou 99,9 %.

Prejsť na prehľad architektúry integrácia webu

Interaktívny príklad

Zmena požiadavky a odpovede pri každom nastavení.

Tu môžete priamo vidieť, ako spolu fungujú jednoduchý jazyk, jednoduchý jazyk, úplné alebo zhustené odpovede a voliteľné informácie o kvalite.

Vstup

Zdrojový text a nastavenia

Zdrojový text

230 / 1000 znakov

Režim

Úroveň podrobnosti

Poznámky ku kvalitePridáva dodatočné informácie o kvalite do odpovede API. Bez tohto nastavenia odpoveď poskytuje iba výsledok.

API požiadavka

{
  "text": "Aby sa urýchlilo spracovanie, používatelia musia po úspešnej registrácii najskôr skontrolovať svoje osobné údaje, v prípade potreby ich aktualizovať a potom proces digitálne potvrdiť. Po odoslaní dostanete správu s ďalšími krokmi.",
  "locale": "sk",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Výstup

Ľahko čitateľný jazyk

Dokončené940 ms

Po odoslaní sa tu zobrazí streamovaný preklad.

API odpoveď

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "sk",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Prihláste sa. Skontrolujte svoje údaje. Zmeňte nepravdivé informácie priamo online. Potvrďte proces digitálne. Potom dostanete správu. Správa obsahuje ďalšie kroky."
  }
}

Štyri architektúry API

Všetky štyri vzory riešia rovnakú technickú úlohu, ale s odlišnou transportnou logikou.

Voľba závisí od toho, či je výsledok potrebný okamžite, či má byť pokrok viditeľný a či volajúci systém môže aktívne čakať, volať alebo byť upozornený prostredníctvom udalosti.

Synchrónna požiadavka HTTP

Príde požiadavka a hotová odpoveď sa vráti v rovnakom HTTP spojení.

Vhodné pre

Priame akcie v používateľskom rozhraní, krátke texty a nízka latencia

Jedna požiadavka + odpoveď streamovania

Požiadavka sa začne spracovávať, odpoveď sa vráti krok za krokom ako prúd.

Vhodné pre

Dlhší obsah, progresívne používateľské rozhranie, viditeľný postup spracovania

Asynchronická úloha + hlasovanie

Prvá požiadavka vytvorí úlohu, potom sa klient opakovane pýta na stav.

Vhodné pre

Dávkové spracovanie, backendy, dlhšie úlohy bez trvalého otvoreného pripojenia

Asynchrónna úloha + webhook

Prvá požiadavka vytvorí úlohu, správa o dokončení sa vráti neskôr cez webhook.

Vhodné pre

CMS workflow, architektúra udalostí, spoľahlivá medzisystémová integrácia

Štyri vzory

Koncept, technická implementácia a konkrétne príklady pre každú architektúru.

Synchrónna požiadavka HTTP

Príde požiadavka a hotová odpoveď sa vráti v rovnakom HTTP spojení.

Výstup API

Volajúci systém odošle požiadavku a aktívne čaká na výsledok. `mode` a `settings` sa odovzdajú v rovnakej požiadavke a priamo určia podobu odpovede.

Jednotlivé texty formulárov posielame priamo na simple8 a okamžite dostaneme príslušnú jazykovú verziu pre zvolený režim.

API

Typický je `POST /api/translate` s textom, jazykovým režimom a nastaveniami.
Ak je úspešný, API priamo vráti `200 OK` so zjednodušeným textom.
Ak `qualityHints=false`, odpoveď neobsahuje ďalšie rady týkajúce sa kvality.

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

Jedna požiadavka + odpoveď streamovania

Požiadavka sa začne spracovávať, odpoveď sa vráti krok za krokom ako prúd.

Výstup API

Klient spustí iba jednu požiadavku, ale nezostane slepý až do konca. Namiesto jedinej konečnej odpovede dostávajú priebežné aktualizácie stavu alebo obsahu cez rovnaké pripojenie.

Náš redakčný tím by mal vidieť, ktorá verzia sa práve vytvára a v prípade potreby okamžite dostať informácie o kvalite.

API

Požiadavka obsahuje rovnaké technické možnosti ako v synchrónnom vzore: `mode`, `rewriteScope` a voliteľne `qualityHints`.
Klient spracúva udalosti ako `status`, `delta` a `completed` bez odosielania nových požiadaviek.
Ak je aktívna `qualityHints`, záverečná správa `completed` môže obsahovať ďalšie rady týkajúce sa kvality.

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

Asynchronická úloha + hlasovanie

Prvá požiadavka vytvorí úlohu, potom sa klient opakovane pýta na stav.

Výstup API

Skutočné spracovanie je oddelené od prvého HTTP volania. Volajúci systém okamžite dostane ID úlohy a neskôr sa sám riadi, keď sa znova pýta na stav.

Náš backend zhromažďuje veľa textov a neskôr sa konkrétne pýta, ktorý variant režimu je pripravený.

API

`POST` vytvorí úlohu a uloží zvolenú kombináciu režimu a nastavení.
Klient sa pýta `GET /api/jobs/{id}` v intervaloch, kým sa neohlási `queued`, `running`, `completed` alebo `failed`.
Výzva je vhodná, keď sú kondenzované alebo analyzované verzie klasifikované do väčších dávkových tokov.

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

Asynchrónna úloha + webhook

Prvá požiadavka vytvorí úlohu, správa o dokončení sa vráti neskôr cez webhook.

Výstup API

Aj tu sa spracovanie spustí asynchrónne. Na rozdiel od pollingu sa klient nepýta na stav opakovane, ale je aktívne informovaný, akonáhle je k dispozícii výsledok alebo chyba.

Náš CMS rozhodne pre každý obsah, či sa použije jednoduchý jazyk alebo jednoduchý jazyk a po webhooku uloží až hotovú verziu.

API

Požiadavka na spustenie okrem technických údajov prenáša aj režim, nastavenia a `webhookUrl`.
Po dokončení odošle API podpísanú udalosť `POST` do cieľového systému.
Webhookové toky sú obzvlášť užitočné pri zavádzaní rôznych výstupných režimov do procesov publikovania alebo vydania.

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