Demo

Könnyen érthető kommunikáció: Tekintse meg az összes API-beállítást működés közben.

A simple8 az összetett tartalmat strukturált, könnyen érthető kommunikációvá alakítja azok számára, akiknek erősebb nyelvi támogatásra van szükségük. Hasonlítsa össze a közérthető nyelv-t és a könnyen érthető kommunikáció-t, a teljes és tömörített kimenetet, az opcionális minőségi tippeket és mind a négy kézbesítési mintát élő kérés- és válaszpéldákkal.

Könnyen érthető kommunikáció

A simple8 az összetett tartalmat strukturált, könnyen érthető kommunikációvá alakítja azok számára, akiknek erősebb nyelvi támogatásra van szükségük.

DIN-szabványoknak megfelelő német nyelvű kimenet

A simple8 német közérthető nyelvű kimenete megfelel a DIN ISO 24495-1 és a DIN 8581-1 követelményeinek. A német könnyen érthető nyelvű kimenet megfelel a DIN SPEC 33429 követelményeinek.

CMS, API és webhelywidget egyetlen sor JavaScripttel

Integrálja a simple8-at WordPress, TYPO3, Drupal, Storyblok és számos más rendszerbe, csatlakoztassa API-n keresztül, vagy adja hozzá a webhelywidgetet egyetlen sor JavaScripttel.

Teljes körű németországi tárhelyszolgáltatás

A simple8 tárhelye és teljes üzemeltetése Németországban van. A tárhelyszolgáltatás és az adatkezelés megfelel a GDPR-nak.

99,9%-os havi rendelkezésre állási SLA

A simple8 99,9%-os havi rendelkezésre állási SLA-t biztosít az éles API-hoz.

Ugrás az architektúra áttekintésére weboldal-integráció

Interaktív példa

Kérelem és válasz módosítása minden beállításnál.

Itt közvetlenül láthatja, hogyan működnek együtt az egyszerű nyelvezet, a könnyű nyelvezet, a teljes vagy tömörített válaszok és az opcionális minőségi információk.

Bemenet

Forrásszöveg és beállítások

Forrásszöveg

275 / 1000 karakter

Mód

Részletesség

Minőségi megjegyzésekTovábbi minőségi információkat ad az API-válaszhoz. E beállítás nélkül a válasz csak az eredményt adja meg.

API-kérés

{
  "text": "A feldolgozás felgyorsítása érdekében a felhasználóknak a sikeres regisztrációt követően először ellenőrizniük kell személyes adataikat, szükség esetén frissíteniük kell, majd digitálisan meg kell erősíteniük a folyamatot. A beküldés után üzenetet kap a következő lépésekről.",
  "locale": "hu",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Kimenet

Könnyen érthető kommunikáció

Befejezve940 ms

Az elküldést követően itt jelenik meg a streamelt fordítás.

API-válasz

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "hu",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Bejelentkezés. Ellenőrizze adatait. Módosítsa a hamis információkat közvetlenül az interneten. Erősítse meg a folyamatot digitálisan. Ezután üzenetet fog kapni. Az üzenet a következő lépéseket tartalmazza."
  }
}

Négy API architektúra

Mind a négy minta ugyanazt a technikai feladatot oldja meg, de eltérő szállítási logikával.

A választás attól függ, hogy azonnal szükség van-e az eredményre, látható-e az előrehaladás, és hogy a hívó rendszer tud-e aktívan várni, lekérdezni vagy eseményen keresztül értesíteni.

Szinkron HTTP kérés

Egy kérés érkezik, és a kész válasz ugyanabban a HTTP-kapcsolatban érkezik vissza.

Alkalmas

Közvetlen műveletek a felületen, rövid szövegek és alacsony késleltetés

Egy kérés + streaming válasz

A kérés feldolgozása megkezdődik, a válasz lépésről lépésre folyamként érkezik vissza.

Alkalmas

Hosszabb tartalom, progresszív felhasználói felület, látható feldolgozási folyamat

Aszinkron feladat + lekérdezés

Az első kérés létrehoz egy jobot, majd a kliens ismételten lekérdezi az állapotot.

Alkalmas

Kötegelt feldolgozás, háttérrendszerek, hosszabb feladatok állandó nyitott kapcsolat nélkül

Aszinkron munka + webhook

Az első kérés egy feladatot hoz létre, a befejezésről szóló üzenet később jön vissza webhookon keresztül.

Alkalmas

CMS munkafolyamatok, eseményarchitektúra, megbízható rendszer-rendszer integráció

A négy minta

Koncepció, műszaki megvalósítás és konkrét példák az egyes architektúrákhoz.

Szinkron HTTP kérés

Egy kérés érkezik, és a kész válasz ugyanabban a HTTP-kapcsolatban érkezik vissza.

Kimenet API

A hívó rendszer kérést küld, és aktívan várja az eredményt. A "mode" és a "settings" ugyanazon kérésben kerülnek átadásra, és közvetlenül meghatározzák a válasz formáját.

Az egyes űrlapszövegeket közvetlenül a simple8-ra küldjük, és azonnal megkapjuk a kiválasztott módnak megfelelő nyelvi verziót.

API

Jellemző egy `POST /api/translate` szöveggel, nyelvi móddal és beállításokkal.
Sikeres esetben az API közvetlenül a „200 OK” értéket adja vissza az egyszerűsített szöveggel.
Ha "qualityHints=false", a válasz nem tartalmaz további minőségi tippeket.

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

Egy kérés + streaming válasz

A kérés feldolgozása megkezdődik, a válasz lépésről lépésre folyamként érkezik vissza.

Kimenet API

A kliens csak egy kérést indít, de nem marad vak a végéig. Egyetlen végső válasz helyett folyamatos állapot- vagy tartalomfrissítéseket kapnak ugyanazon a kapcsolaton keresztül.

Szerkesztőségünknek látnia kell, melyik verzió készül éppen, és szükség esetén azonnal megkapja a minőségi információkat.

API

A kérés ugyanazokat a technikai beállításokat tartalmazza, mint a szinkronmintában: "mode", "rewriteScope" és opcionálisan "qualityHints".
A kliens olyan eseményeket dolgoz fel, mint a `status`, `delta` és `completed`, új kérések indítása nélkül.
Ha a `qualityHints` aktív, a végső `completed` üzenet további minőségi megjegyzéseket tartalmazhat.

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

Aszinkron feladat + lekérdezés

Az első kérés létrehoz egy jobot, majd a kliens ismételten lekérdezi az állapotot.

Kimenet API

A tényleges feldolgozás leválasztásra kerül az első HTTP-hívástól. A hívó rendszer azonnal kap egy jobazonosítót, és később saját magát ellenőrzi, amikor ismét lekérdezi az állapotot.

A háttérprogramunk rengeteg szöveget gyűjt, és később konkrétan rákérdez, hogy melyik módváltozat áll készen.

API

A "POST" létrehoz egy feladatot, és elmenti a módok és beállítások kiválasztott kombinációját.
A kliens időközönként lekérdezi a `GET /api/jobs/{id}` végpontot, amíg a rendszer `queued`, `running`, `completed` vagy `failed` állapotot nem jelez.
A lekérdezés jól használható, ha a sűrített vagy elemzett változatokat nagyobb tételfolyamokba sorolják.

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

Aszinkron munka + webhook

Az első kérés egy feladatot hoz létre, a befejezésről szóló üzenet később jön vissza webhookon keresztül.

Kimenet API

Itt is aszinkron módon indul a feldolgozás. A lekérdezéssel ellentétben a kliens nem kérdezi le ismételten az állapotot, hanem aktívan értesíti, amint eredmény vagy hiba elérhető.

CMS-ünk minden tartalomnál eldönti, hogy egyszerű vagy egyszerű nyelvet használ-e, és csak a kész verziót menti el a webhook után.

API

Az indítási kérés a technikai adatokon kívül módot, beállításokat és `webhookUrl`-t is továbbít.
A befejezést követően az API aláírt POST eseményt küld a célrendszernek.
A Webhook-folyamatok különösen hasznosak, ha különböző kimeneti módokat táplál be a közzétételi vagy kiadási folyamatokba.

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