Demo

Selkokieli: Katso kaikki API-asetukset toiminnassa.

simple8 muuntaa monimutkaisen sisällön jäsennellyksi selkokieleksi ihmisille, jotka tarvitsevat vahvempaa kielellistä tukea. Vertaa selkeä kieli:ta ja selkokieli:ta, täydellistä ja tiivistettyä lähtöä, valinnaisia laatuvinkkejä ja kaikkia neljää toimitusmallia live-pyyntö- ja vastausesimerkeillä.

Selkokieli

simple8 muuntaa monimutkaisen sisällön jäsennellyksi selkokieleksi ihmisille, jotka tarvitsevat vahvempaa kielellistä tukea.

DIN-standardien mukainen saksankielinen sisältö

simple8in saksankieliset selkeän kielen tuotokset täyttävät DIN ISO 24495-1:n ja DIN 8581-1:n vaatimukset. Saksankieliset selkokieliset tuotokset täyttävät DIN SPEC 33429:n vaatimukset.

CMS, API ja verkkosivuston widget yhdellä JavaScript-rivillä

Integroi simple8 WordPressiin, TYPO3:een, Drupaliin, Storyblokiin ja moniin muihin järjestelmiin, yhdistä se API:n kautta tai lisää verkkosivuston widget yhdellä JavaScript-rivillä.

Hosting kokonaan Saksassa

simple8-palvelua ylläpidetään ja operoidaan kokonaan Saksassa. Hosting ja tietojenkäsittely ovat GDPR:n mukaisia.

99,9 %:n kuukausittaisen käytettävyyden SLA

simple8 tarjoaa tuotanto-API:lle SLA:n, joka takaa 99,9 %:n kuukausittaisen käytettävyyden.

Siirry arkkitehtuurin yleiskatsaukseen verkkosivustointegraatio

Interaktiivinen esimerkki

Pyynnön ja vastauksen muutos jokaisen asetuksen yhteydessä.

Täältä näet suoraan, kuinka yksinkertainen kieli, helppo kieli, täydelliset tai tiivistetyt vastaukset ja valinnainen laatutieto toimivat yhdessä.

Syöte

Lähtöteksti ja asetukset

Lähtöteksti

249 / 1000 merkkiä

Tila

Yksityiskohtaisuuden taso

LaatuhuomiotLisää laatutietoja API-vastaukseen. Ilman tätä asetusta vastaus antaa vain tuloksen.

API-pyyntö

{
  "text": "Käsittelyn nopeuttamiseksi käyttäjien tulee ensin tarkistaa henkilökohtaiset tietonsa onnistuneen rekisteröinnin jälkeen, päivittää ne tarvittaessa ja vahvistaa prosessi sitten digitaalisesti. Lähettämisen jälkeen saat viestin seuraavista vaiheista.",
  "locale": "fi",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Tulos

Selkokieli

Valmis940 ms

Lähetyksen jälkeen suoratoistettu käännös näkyy tässä.

API-vastaus

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "fi",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Kirjaudu sisään. Tarkista tietosi. Vaihda väärät tiedot suoraan verkossa. Vahvista prosessi digitaalisesti. Saat sitten viestin. Viesti sisältää seuraavat vaiheet."
  }
}

Neljä API-arkkitehtuuria

Kaikki neljä mallia ratkaisevat saman teknisen tehtävän, mutta eri kuljetuslogiikalla.

Valinta riippuu siitä, tarvitaanko tulosta välittömästi, onko edistymisen näkyvissä ja voiko kutsuva järjestelmä odottaa aktiivisesti, pollata vai saada ilmoituksen tapahtuman kautta.

Synkroninen HTTP-pyyntö

Pyyntö menee sisään ja valmis vastaus tulee takaisin samassa HTTP-yhteydessä.

Sopii

Suorat käyttöliittymätoiminnot, lyhyet tekstit ja pieni viive

Yksi pyyntö + suoratoistovastaus

Pyynnön käsittely alkaa, vastaus palaa askel askeleelta streamina.

Sopii

Pidempi sisältö, progressiivinen käyttöliittymä, näkyvä käsittelyn edistyminen

Asynkronoitu työ + kysely

Ensimmäinen pyyntö luo työn, jonka jälkeen asiakas kyselee tilaa toistuvasti.

Sopii

Eräkäsittely, taustajärjestelmät, pidemmät työt ilman jatkuvaa avointa yhteyttä

Asynkronointityö + webhook

Ensimmäinen pyyntö luo työn, valmistumisviesti tulee myöhemmin takaisin webhookin kautta.

Sopii

CMS-työnkulut, tapahtumaarkkitehtuuri, luotettava järjestelmien välinen integrointi

Neljä mallia

Konsepti, tekninen toteutus ja konkreettisia esimerkkejä jokaisesta arkkitehtuurista.

Synkroninen HTTP-pyyntö

Pyyntö menee sisään ja valmis vastaus tulee takaisin samassa HTTP-yhteydessä.

Tulos API

Kutsuva järjestelmä lähettää pyynnön ja odottaa aktiivisesti tulosta. `mode` ja `settings` välitetään samassa pyynnössä ja ne määrittävät vastauksen muodon.

Lähetämme yksittäiset lomaketekstit suoraan simple8:aan ja saamme välittömästi valitun tilan oikeankielisen version.

API

"POST /api/translate", jossa on teksti, kielitila ja asetukset, on tyypillinen.
Jos onnistuu, API palauttaa suoraan "200 OK" yksinkertaistetulla tekstillä.
Kun `qualityHints=false`, vastaus ei sisällä lisähuomautuksia laadusta.

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

Yksi pyyntö + suoratoistovastaus

Pyynnön käsittely alkaa, vastaus palaa askel askeleelta streamina.

Tulos API

Asiakas aloittaa vain yhden pyynnön, mutta ei pysy sokeana loppuun asti. Yhden lopullisen vastauksen sijaan he saavat jatkuvan tila- tai sisältöpäivitykset saman yhteyden kautta.

Toimitustiimimme pitäisi nähdä, mikä versio on parhaillaan luomassa, ja tarvittaessa saada laatutiedot välittömästi.

API

Pyyntö sisältää samat tekniset vaihtoehdot kuin synkronisessa mallissa: "mode", "rewriteScope" ja valinnaisesti "qualityHints".
Asiakas käsittelee tapahtumia, kuten "status", "delta" ja "completed" lähettämättä uusia pyyntöjä.
Kun `qualityHints` on käytössä, lopullinen `completed`-viesti voi sisältää lisää laatuohjeita.

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

Asynkronoitu työ + kysely

Ensimmäinen pyyntö luo työn, jonka jälkeen asiakas kyselee tilaa toistuvasti.

Tulos API

Varsinainen käsittely irrotetaan ensimmäisestä HTTP-kutsusta. Soittava järjestelmä vastaanottaa välittömästi työtunnuksen ja valvoo myöhemmin itseään, kun se kysyy tilaa uudelleen.

Taustajärjestelmämme kerää paljon tekstejä ja kysyy myöhemmin erikseen, mikä tilaversio on valmis.

API

"POST" luo työn ja tallentaa valitun tilan ja asetusten yhdistelmän.
Asiakasohjelma kysyy `GET /api/jobs/{id}`-päätepistettä säännöllisin väliajoin, kunnes tilaksi ilmoitetaan `queued`, `running`, `completed` tai `failed`.
Pollaus soveltuu hyvin, kun tiivistetyt tai analysoidut versiot luokitellaan suurempiin erävirtoihin.

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

Asynkronointityö + webhook

Ensimmäinen pyyntö luo työn, valmistumisviesti tulee myöhemmin takaisin webhookin kautta.

Tulos API

Myös tässä käsittely aloitetaan asynkronisesti. Toisin kuin kyselyssä, asiakas ei kysele tilaa toistuvasti, vaan hänelle ilmoitetaan aktiivisesti heti, kun tulos tai virhe on saatavilla.

Sisällönhallintajärjestelmämme päättää jokaiselle sisällölle, käytetäänkö yksinkertaista vai helppoa kieltä, ja tallentaa vain valmiin version webhookin jälkeen.

API

Käynnistyspyyntö lähettää teknisten tietojen lisäksi myös tilan, asetukset ja `webhookUrl'n.
Valmistuttuaan API lähettää allekirjoitetun POST-tapahtuman kohdejärjestelmään.
Webhook-virrat ovat erityisen hyödyllisiä syötettäessä eri tulostustiloja julkaisu- tai julkaisuprosesseihin.

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