Demo

Lihtsalt loetav ja mõistetav: Vaadake iga API seadet töös.

simple8 muudab keeruka sisu struktureeritud, lihtsalt loetavaks ja mõistetavaks tekstiks inimestele, kes vajavad tugevamat keeletuge. Võrrelge selge keel ja lihtsalt loetav ja mõistetav, täielikku ja koondatud väljundit, valikulisi kvaliteedivihjeid ja kõiki nelja tarnemustrit reaalajas päringu ja vastuse näidetega.

Lihtsalt loetav ja mõistetav

simple8 muudab keeruka sisu struktureeritud, lihtsalt loetavaks ja mõistetavaks tekstiks inimestele, kes vajavad tugevamat keeletuge.

DIN-standarditele vastav saksakeelne väljund

simple8 väljund saksa selges keeles vastab standarditele DIN ISO 24495-1 ja DIN 8581-1. Väljund saksa lihtsalt loetavas ja mõistetavas keeles vastab standardile DIN SPEC 33429.

CMS, API ja veebisaidi vidin ühe JavaScripti reaga

Integreerige simple8 WordPressi, TYPO3, Drupali ja Storyblokiga ning paljude teiste süsteemidega, ühendage see API kaudu või lisage veebisaidi vidin ühe JavaScripti reaga.

Majutus täielikult Saksamaal

simple8 majutatakse ja seda käitatakse täielikult Saksamaal. Majutus ja andmetöötlus vastavad GDPR-ile.

99,9% igakuise käideldavuse SLA

simple8 pakub tootmis-API-le 99,9% igakuise käideldavuse SLA-d.

Hüppa arhitektuuri ülevaate juurde veebisaidi integratsioon

Interaktiivne näide

Taotluse ja vastuse muutmine iga seadega.

Siin näete otse, kuidas lihtne keel, lihtne keelekasutus, täielikud või lühendatud vastused ja valikuline kvaliteetteave koos töötavad.

Sisend

Lähtetekst ja seaded

Lähtetekst

227 / 1000 tähemärki

Režiim

Üksikasjalikkuse tase

KvaliteedimärkusedLisab API vastusele täiendavat kvaliteediteavet. Ilma selle sätteta annab vastus ainult tulemuse.

API päring

{
  "text": "Töötlemise kiirendamiseks peavad kasutajad pärast edukat registreerimist esmalt oma isikuandmeid kontrollima, vajadusel uuendama ning seejärel protsessi digitaalselt kinnitama. Pärast esitamist saate sõnumi järgmiste sammudega.",
  "locale": "et",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Väljund

Lihtsalt loetav ja mõistetav

Valmis940 ms

Pärast saatmist kuvatakse siin voogesitatud tõlge.

API vastus

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "et",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Logige sisse. Kontrollige oma teavet. Muutke valeteavet otse võrgus. Kinnitage protsess digitaalselt. Seejärel saate sõnumi. Sõnum sisaldab järgmisi samme."
  }
}

Neli API arhitektuuri

Kõik neli mustrit lahendavad sama tehnilise ülesande, kuid erineva transpordiloogikaga.

Valik sõltub sellest, kas tulemust on vaja koheselt, kas edusammud peaksid olema nähtavad ja kas helistav süsteem saab aktiivselt oodata, küsitleda või sündmuse kaudu teavitada.

Sünkroonne HTTP-päring

Päring siseneb ja valmis vastus tuleb tagasi samas HTTP-ühenduses.

Sobib

Otsesed toimingud kasutajaliideses, lühikesed tekstid ja väike latentsus

Üks päring + voogesituse vastus

Taotlust hakatakse töötlema, vastus tuleb samm-sammult tagasi voona.

Sobib

Pikem sisu, progressiivne kasutajaliides, nähtav töötlemise edenemine

Asünkroonimistöö + küsitlus

Esimene päring loob töö, seejärel küsib klient olekut korduvalt.

Sobib

Pakktöötlus, taustaprogrammid, pikemad tööd ilma püsiva avatud ühenduseta

Asünkroonimistöö + veebihaak

Esimene päring loob töö, lõpetamise teade tuleb hiljem veebihaagi kaudu tagasi.

Sobib

CMS-i töövood, sündmuste arhitektuur, usaldusväärne süsteemidevaheline integratsioon

Neli mustrit

Iga arhitektuuri kontseptsioon, tehniline teostus ja konkreetsed näited.

Sünkroonne HTTP-päring

Päring siseneb ja valmis vastus tuleb tagasi samas HTTP-ühenduses.

Väljund API

Kutsuv süsteem saadab päringu ja ootab aktiivselt tulemust. `mode` ja `settings` edastatakse samas päringus ning määravad otse vastuse kuju.

Saadame üksikud vormitekstid otse lihtsale8-le ja saame koheselt valitud režiimi jaoks sobiva keeleversiooni.

API

Tüüpiline on teksti, keelerežiimi ja sätetega POST /api/translate
Edu korral tagastab API otse „200 OK” koos lihtsustatud tekstiga.
Kui „qualityHints=false”, ei sisalda vastus täiendavaid kvaliteedivihjeid.

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

Üks päring + voogesituse vastus

Taotlust hakatakse töötlema, vastus tuleb samm-sammult tagasi voona.

Väljund API

Klient alustab ainult ühte päringut, kuid ei jää lõpuni pimedaks. Ühe lõpliku vastuse asemel saavad nad sama ühenduse kaudu jooksvaid oleku- või sisuvärskendusi.

Meie toimetus peaks nägema, milline versioon on parasjagu loomisel, ja vajadusel saama kohe kvaliteetse teabe.

API

Taotlus sisaldab samu tehnilisi valikuid, mis sünkroonse mustri puhul: "mode", "rewriteScope" ja valikuliselt "qualityHints".
Klient töötleb sündmusi nagu `status`, `delta` ja `completed` ilma uusi päringuid saatmata.
Kui `qualityHints` on aktiivne, võib lõplik sõnum `completed` sisaldada täiendavaid kvaliteedijuhiseid.

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

Asünkroonimistöö + küsitlus

Esimene päring loob töö, seejärel küsib klient olekut korduvalt.

Väljund API

Tegelik töötlemine eraldatakse esimesest HTTP-kõnest. Helistav süsteem saab koheselt töö ID ja kontrollib end hiljem uuesti olekupäringu korral.

Meie taustaprogramm kogub palju tekste ja küsib hiljem konkreetselt, milline režiimivariant on valmis.

API

POST loob töö ning salvestab valitud režiimi ja sätete kombinatsiooni.
Klient pärib `GET /api/jobs/{id}` korrapäraste ajavahemike järel, kuni teatatakse olek `queued`, `running`, `completed` või `failed`.
Küsitlus sobib hästi siis, kui koondatud või analüüsitud versioonid liigitatakse suuremateks partiivoogudeks.

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

Asünkroonimistöö + veebihaak

Esimene päring loob töö, lõpetamise teade tuleb hiljem veebihaagi kaudu tagasi.

Väljund API

Ka siin alustatakse töötlemist asünkroonselt. Erinevalt küsitlemisest ei küsi klient olekut korduvalt, vaid teda teavitatakse aktiivselt kohe, kui tulemus või viga on teada.

Meie CMS otsustab iga sisu puhul, kas kasutatakse lihtsat või lihtsat keelt, ja salvestab valmis versiooni alles pärast veebihaaki.

API

Lisaks tehnilistele andmetele edastab käivituspäring ka režiimi, seaded ja `webhookUrl`.
Lõpetamisel saadab API sihtsüsteemi allkirjastatud POST-sündmuse.
Veebihaagi vood on eriti kasulikud erinevate väljundrežiimide sisestamisel avaldamis- või väljalaskeprotsessidesse.

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