Demo

Snadné čtení: Podívejte se na každé nastavení API v akci.

simple8 převádí složitý obsah do strukturované podoby pro snadné čtení pro lidi, kteří potřebují silnější jazykovou podporu. Porovnejte srozumitelný jazyk a snadné čtení, kompletní a zhuštěný výstup, volitelné rady ohledně kvality a všechny čtyři vzory doručení s živými příklady požadavků a odpovědí.

Snadné čtení

simple8 převádí složitý obsah do strukturované podoby pro snadné čtení pro lidi, kteří potřebují silnější jazykovou podporu.

Německé výstupy v souladu s DIN

Výstupy simple8 v německém srozumitelném jazyce jsou v souladu s DIN ISO 24495-1 a DIN 8581-1. Výstupy v německém snadno čitelném jazyce jsou v souladu s DIN SPEC 33429.

CMS, API a webový widget s jedním řádkem JavaScriptu

Integrujte simple8 se systémy WordPress, TYPO3, Drupal a Storyblok a mnoha dalšími systémy, připojte jej přes API nebo přidejte webový widget jedním řádkem JavaScriptu.

Hosting výhradně v Německu

simple8 je kompletně hostován a provozován v Německu. Hosting a zpracování dat jsou v souladu s GDPR.

SLA s měsíční dostupností 99,9 %

simple8 poskytuje pro produkční API SLA s měsíční dostupností 99,9 %.

Přejít na přehled architektury integrace do webu

Interaktivní příklad

Změna požadavku a odpovědi s každým nastavením.

Zde můžete přímo vidět, jak jednoduchý jazyk, jednoduchý jazyk, úplné nebo zhuštěné odpovědi a volitelné informace o kvalitě spolupracují.

Vstup

Výchozí text a nastavení

Výchozí text

213 / 1000 znaků

Režim

Úroveň podrobnosti

Poznámky ke kvalitěPřidá další informace o kvalitě do odpovědi API. Bez tohoto nastavení poskytuje odpověď pouze výsledek.

API požadavek

{
  "text": "Pro urychlení zpracování musí uživatelé po úspěšné registraci nejprve zkontrolovat své osobní údaje, v případě potřeby je aktualizovat a poté proces digitálně potvrdit. Po odeslání obdržíte zprávu s dalšími kroky.",
  "locale": "cs",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Výstup

Snadné čtení

Dokončeno940 ms

Po odeslání se zde zobrazí streamovaný překlad.

API odpověď

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "cs",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Přihlaste se. Zkontrolujte své údaje. Změňte nepravdivé informace přímo online. Potvrďte proces digitálně. Poté obdržíte zprávu. Zpráva obsahuje další kroky."
  }
}

Čtyři architektury API

Všechny čtyři vzory řeší stejný technický úkol, ale s odlišnou transportní logikou.

Volba závisí na tom, zda je výsledek potřebný okamžitě, zda má být viditelný průběh a zda volající systém může aktivně čekat, dotazovat se nebo být informován prostřednictvím události.

Synchronní požadavek HTTP

Přijde požadavek a dokončená odpověď se vrátí ve stejném připojení HTTP.

Vhodné pro

Přímé akce v uživatelském rozhraní, krátké texty a nízká latence

Jeden požadavek + odezva streamování

Požadavek se začne zpracovávat, odpověď se vrací krok za krokem jako proud.

Vhodné pro

Delší obsah, progresivní uživatelské rozhraní, viditelný postup zpracování

Asynchronní úloha + dotazování

První požadavek vytvoří úlohu, poté se klient opakovaně dotazuje na stav.

Vhodné pro

Dávkové zpracování, backendy, delší úlohy bez trvalého otevřeného připojení

Asynchronní úloha + webhook

První požadavek vytvoří úlohu, zpráva o dokončení se vrátí později prostřednictvím webhooku.

Vhodné pro

Pracovní postupy CMS, architektura událostí, spolehlivá integrace mezi systémy

Čtyři vzory

Koncept, technická implementace a konkrétní příklady pro každou architekturu.

Synchronní požadavek HTTP

Přijde požadavek a dokončená odpověď se vrátí ve stejném připojení HTTP.

Výstup API

Volající systém odešle požadavek a aktivně čeká na výsledek. `mode` a `settings` se předají ve stejném požadavku a přímo určují podobu odpovědi.

Jednotlivé texty formulářů posíláme přímo na simple8 a obratem obdržíme příslušnou jazykovou verzi pro zvolený režim.

API

Typický je `POST /api/translate` s textem, jazykovým režimem a nastavením.
V případě úspěchu vrátí API přímo `200 OK` se zjednodušeným textem.
Pokud je `qualityHints=false`, odpověď neobsahuje další rady týkající se 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."
  }
}

Jeden požadavek + odezva streamování

Požadavek se začne zpracovávat, odpověď se vrací krok za krokem jako proud.

Výstup API

Klient spustí pouze jeden požadavek, ale nezůstane slepý až do konce. Místo jediné konečné odpovědi dostávají průběžné aktualizace stavu nebo obsahu prostřednictvím stejného připojení.

Náš redakční tým by měl vidět, která verze se právě vytváří, a v případě potřeby okamžitě obdržet informace o kvalitě.

API

Požadavek obsahuje stejné technické možnosti jako v synchronním vzoru: `mode`, `rewriteScope` a volitelně `qualityHints`.
Klient zpracovává události jako `status`, `delta` a `completed`, aniž by odesílal nové požadavky.
Pokud je aktivní `qualityHints`, závěrečná zpráva `completed` může obsahovat další rady týkající se 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."
    ]
  }
}

Asynchronní úloha + dotazování

První požadavek vytvoří úlohu, poté se klient opakovaně dotazuje na stav.

Výstup API

Vlastní zpracování je odděleno od prvního HTTP volání. Volající systém okamžitě obdrží ID úlohy a později se sám řídí, když se znovu dotáže na stav.

Náš backend shromažďuje spoustu textů a později se konkrétně ptá, která varianta režimu je připravena.

API

„POST“ vytvoří úlohu a uloží vybranou kombinaci režimu a nastavení.
Klient se dotazuje `GET /api/jobs/{id}` v intervalech, dokud není hlášeno `queued`, `running`, `completed` nebo `failed`.
Polling je vhodný, když jsou zhuštěné nebo analyzované verze klasifikovány do větších dávkových toků.

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

Asynchronní úloha + webhook

První požadavek vytvoří úlohu, zpráva o dokončení se vrátí později prostřednictvím webhooku.

Výstup API

I zde je zpracování spuštěno asynchronně. Na rozdíl od dotazování se klient neptá na stav opakovaně, ale je aktivně informován, jakmile je k dispozici výsledek nebo chyba.

Náš CMS pro každý obsah rozhodne, zda se použije jednoduchý jazyk nebo jednoduchý jazyk, a po webhooku uloží až hotovou verzi.

API

Kromě technických údajů přenáší požadavek na spuštění také režim, nastavení a `webhookUrl`.
Po dokončení odešle API podepsanou událost `POST` do cílového systému.
Webhookové toky jsou zvláště užitečné při zavádění různých výstupních režimů do procesů publikování nebo vydávání.

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