Demo

Lahko berljivo in razumljivo: Oglejte si vsako nastavitev API-ja v akciji.

simple8 pretvori zapleteno vsebino v strukturirano, lahko berljivo in razumljivo besedilo za ljudi, ki potrebujejo močnejšo jezikovno podporo. Primerjajte jasen jezik in lahko berljivo in razumljivo, popoln in zgoščen izpis, izbirne namige o kakovosti in vse štiri vzorce dostave s primeri zahtev in odgovorov v živo.

Lahko berljivo in razumljivo

simple8 pretvori zapleteno vsebino v strukturirano, lahko berljivo in razumljivo besedilo za ljudi, ki potrebujejo močnejšo jezikovno podporo.

Nemški izpisi, skladni s standardi DIN

Izpisi simple8 v jasnem nemškem jeziku so skladni z DIN ISO 24495-1 in DIN 8581-1. Izpisi v lahko berljivem in razumljivem nemškem jeziku so skladni z DIN SPEC 33429.

CMS, API in spletni gradnik z eno vrstico JavaScripta

Integrirajte simple8 z WordPressom, TYPO3, Drupalom, Storyblokom in številnimi drugimi sistemi, povežite ga prek API-ja ali dodajte spletni gradnik z eno vrstico JavaScripta.

Gostovanje v celoti v Nemčiji

simple8 v celoti gostuje in deluje v Nemčiji. Gostovanje in obdelava podatkov sta skladna z GDPR.

SLA za 99,9 % mesečno razpoložljivost

simple8 za produkcijski API zagotavlja SLA z 99,9 % mesečno razpoložljivostjo.

Skoči na pregled arhitekture integracija spletnih mest

Interaktiven primer

Zahteva in odgovor se spremenita z vsako nastavitvijo.

Tukaj lahko neposredno vidite, kako preprost jezik, enostaven jezik, popolni ali zgoščeni odgovori in neobvezne kakovostne informacije delujejo skupaj.

Vhod

Izvorno besedilo in nastavitve

Izvorno besedilo

226 / 1000 znakov

Način

Raven podrobnosti

Opombe o kakovostiOdgovoru API-ja doda dodatne informacije o kakovosti. Brez te nastavitve odgovor zagotavlja samo rezultat.

Zahteva API

{
  "text": "Da bi pospešili obdelavo, morajo uporabniki po uspešni registraciji najprej preveriti svoje osebne podatke, jih po potrebi posodobiti in nato postopek digitalno potrditi. Po oddaji boste prejeli sporočilo z nadaljnjimi koraki.",
  "locale": "sl",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Izhod

Lahko berljivo in razumljivo

Dokončano940 ms

Po pošiljanju se tukaj prikaže pretočni prevod.

Odgovor API

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "sl",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Prijavite se. Preverite svoje podatke. Spremenite lažne podatke neposredno na spletu. Digitalno potrdite postopek. Nato boste prejeli sporočilo. Sporočilo vsebuje naslednje korake."
  }
}

Štiri arhitekture API

Vsi štirje vzorci rešujejo isto tehnično nalogo, vendar z različno transportno logiko.

Izbira je odvisna od tega, ali je rezultat potreben takoj, ali mora biti napredek viden in ali lahko klicni sistem aktivno čaka, anketira ali je obveščen prek dogodka.

Sinhronizirana zahteva HTTP

Zahteva vstopi in končni odgovor se vrne v isti povezavi HTTP.

Primerno za

Neposredna dejanja v uporabniškem vmesniku, kratka besedila in nizka zakasnitev

Ena zahteva + pretočni odgovor

Zahteva se začne obdelovati, odgovor se vrača korak za korakom kot tok.

Primerno za

Daljša vsebina, napreden uporabniški vmesnik, viden napredek obdelave

Asinhrono opravilo + anketiranje

Prva zahteva ustvari opravilo, nato odjemalec večkrat poizveduje o statusu.

Primerno za

Paketna obdelava, zaledja, daljša opravila brez trajne odprte povezave

Asinhrono opravilo + webhook

Prva zahteva ustvari opravilo, sporočilo o zaključku se vrne pozneje prek webhooka.

Primerno za

Poteki dela CMS, arhitektura dogodkov, zanesljiva medsistemska integracija

Štirje vzorci

Koncept, tehnična izvedba in konkretni primeri za vsako arhitekturo.

Sinhronizirana zahteva HTTP

Zahteva vstopi in končni odgovor se vrne v isti povezavi HTTP.

Izhod API

Klicajoči sistem pošlje zahtevo in aktivno čaka na rezultat. `mode` in `settings` sta posredovana v isti zahtevi in neposredno določata obliko odgovora.

Posamezna besedila obrazcev pošljemo neposredno na simple8 in takoj prejmemo ustrezno jezikovno različico za izbrani način.

API

Tipičen je `POST /api/translate` z besedilom, jezikovnim načinom in nastavitvami.
Če je uspešen, API neposredno vrne `200 OK` s poenostavljenim besedilom.
Če je `qualityHints=false`, odgovor ne vsebuje dodatnih namigov o kakovosti.

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

Ena zahteva + pretočni odgovor

Zahteva se začne obdelovati, odgovor se vrača korak za korakom kot tok.

Izhod API

Odjemalec začne le eno zahtevo, vendar ne ostane slep do konca. Namesto enega samega končnega odgovora prejemajo stalne posodobitve stanja ali vsebine prek iste povezave.

Naše uredništvo bi moralo videti, katera različica trenutno nastaja, in po potrebi takoj prejeti informacije o kakovosti.

API

Zahteva vsebuje enake tehnične možnosti kot v sinhronem vzorcu: `mode`, `rewriteScope` in opcijsko `qualityHints`.
Odjemalec obdela dogodke, kot so `status`, `delta` in `completed`, ne da bi izdal nove zahteve.
Če je `qualityHints` aktiven, lahko končno sporočilo `completed` vsebuje dodatne namige o kakovosti.

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

Asinhrono opravilo + anketiranje

Prva zahteva ustvari opravilo, nato odjemalec večkrat poizveduje o statusu.

Izhod API

Dejanska obdelava je ločena od prvega klica HTTP. Sistem, ki kliče, takoj prejme ID opravila in se kasneje sam nadzira, ko znova poizveduje o statusu.

Naše zaledje zbere veliko besedil in pozneje posebej vpraša, katera različica načina je pripravljena.

API

`POST` ustvari opravilo in shrani izbrano kombinacijo načina in nastavitev.
Odjemalec anketira `GET /api/jobs/{id}` v intervalih, dokler se ne sporoči `queued`, `running`, `completed` ali `failed`.
Preizkušanje je zelo primerno, ko so zgoščene ali analizirane različice razvrščene v večje paketne tokove.

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

Asinhrono opravilo + webhook

Prva zahteva ustvari opravilo, sporočilo o zaključku se vrne pozneje prek webhooka.

Izhod API

Tudi tukaj se obdelava začne asinhrono. Za razliko od anketiranja odjemalec ne sprašuje o statusu večkrat, ampak je aktivno obveščen takoj, ko je na voljo rezultat ali napaka.

Naš CMS se za vsako vsebino odloči, ali je uporabljen preprost jezik ali enostaven jezik, in shrani končano različico šele po webhooku.

API

Poleg tehničnih podatkov zahteva za zagon posreduje tudi način, nastavitve in `webhookUrl`.
Po zaključku API pošlje ciljnemu sistemu podpisan dogodek `POST`.
Tokovi Webhook so še posebej uporabni pri vnašanju različnih izhodnih načinov v procese objave ali izdaje.

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