Demo

Lako čitljiv jezik: Pogledajte svaku API postavku na djelu.

simple8 pretvara složen sadržaj u strukturiran i lako čitljiv jezik za ljude kojima je potrebna snažnija jezična podrška. Usporedite jasan jezik i lako čitljiv jezik, potpuni i sažeti ispis, izborne savjete o kvaliteti i sva četiri obrasca isporuke sa živim primjerima zahtjeva i odgovora.

Lako čitljiv jezik

simple8 pretvara složen sadržaj u strukturiran i lako čitljiv jezik za ljude kojima je potrebna snažnija jezična podrška.

Njemački rezultati usklađeni s DIN-om

Rezultati simple8 na jasnom njemačkom jeziku usklađeni su s DIN ISO 24495-1 i DIN 8581-1. Rezultati na lako čitljivom njemačkom jeziku usklađeni su s DIN SPEC 33429.

CMS, API i widget za web stranicu s jednim retkom JavaScripta

Integrirajte simple8 s WordPressom, TYPO3-om, Drupalom, Storyblokom i mnogim drugim sustavima, povežite ga putem API-ja ili dodajte widget na web stranicu jednim retkom JavaScripta.

Hosting u cijelosti u Njemačkoj

simple8 se u cijelosti hostira i njime se upravlja u Njemačkoj. Hosting i obrada podataka usklađeni su s GDPR-om.

SLA od 99,9 % mjesečne dostupnosti

simple8 pruža SLA od 99,9 % mjesečne dostupnosti za produkcijski API.

Skoči na pregled arhitekture integracija web stranica

Interaktivni primjer

Zahtjev i odgovor se mijenjaju sa svakom postavkom.

Ovdje možete izravno vidjeti kako jednostavan jezik, jednostavan jezik, potpuni ili sažeti odgovori i neobvezne kvalitetne informacije funkcioniraju zajedno.

Ulaz

Izvorni tekst i postavke

Izvorni tekst

233 / 1000 znakova

Način rada

Razina detalja

Napomene o kvalitetiDodaje dodatne informacije o kvaliteti API odgovoru. Bez ove postavke, odgovor daje samo rezultat.

API zahtjev

{
  "text": "Kako bi se ubrzala obrada, korisnici moraju prvo provjeriti svoje osobne podatke nakon uspješne registracije, ažurirati ih ako je potrebno i zatim digitalno potvrditi proces. Nakon podnošenja primit ćete poruku sa sljedećim koracima.",
  "locale": "hr",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Izlaz

Lako čitljiv jezik

Završeno940 ms

Nakon slanja, ovdje će se pojaviti strujani prijevod.

API odgovor

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "hr",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Prijavite se. Provjerite svoje podatke. Promijenite lažne podatke izravno na mreži. Digitalno potvrdite postupak. Tada ćete primiti poruku. Poruka sadrži sljedeće korake."
  }
}

Četiri API arhitekture

Sva četiri uzorka rješavaju isti tehnički zadatak, ali s različitom transportnom logikom.

Izbor ovisi o tome je li rezultat potreban odmah, treba li napredak biti vidljiv i može li sustav koji poziva aktivno čekati, anketirati ili biti obaviješten putem događaja.

Sinkroni HTTP zahtjev

Zahtjev ulazi i gotov odgovor se vraća u istoj HTTP vezi.

Pogodno za

Izravne radnje u korisničkom sučelju, kratki tekstovi i niska latencija

Jedan zahtjev + streaming odgovor

Zahtjev počinje s obradom, odgovor se vraća korak po korak kao tok.

Pogodno za

Dulji sadržaj, progresivno korisničko sučelje, vidljiv napredak obrade

Asinkroni posao + prozivanje

Prvi zahtjev stvara posao, zatim klijent više puta ispituje status.

Pogodno za

Skupna obrada, pozadina, duži poslovi bez stalne otvorene veze

Asinkroni posao + webhook

Prvi zahtjev stvara posao, poruka o završetku vraća se kasnije putem webhooka.

Pogodno za

CMS tijekovi rada, arhitektura događaja, pouzdana integracija između sustava

Četiri uzorka

Koncept, tehnička izvedba i konkretni primjeri za svaku arhitekturu.

Sinkroni HTTP zahtjev

Zahtjev ulazi i gotov odgovor se vraća u istoj HTTP vezi.

Izlaz API

Pozivni sustav šalje zahtjev i aktivno čeka rezultat. `mode` i `settings` prosljeđuju se u istom zahtjevu i izravno određuju oblik odgovora.

Tekstove pojedinačnih obrazaca šaljemo izravno na simple8 i odmah primamo odgovarajuću jezičnu verziju za odabrani način.

API

Tipičan je `POST /api/translate` s tekstom, načinom jezika i postavkama.
Ako je uspješan, API izravno vraća `200 OK` s pojednostavljenim tekstom.
Ako je `qualityHints=false`, odgovor ne sadrži dodatne savjete o kvaliteti.

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

Jedan zahtjev + streaming odgovor

Zahtjev počinje s obradom, odgovor se vraća korak po korak kao tok.

Izlaz API

Klijent pokreće samo jedan zahtjev, ali ne ostaje slijep do kraja. Umjesto jednog jedinog konačnog odgovora, oni primaju tekuća ažuriranja statusa ili sadržaja preko iste veze.

Naš urednički tim trebao bi vidjeti koja je verzija trenutno u izradi i po potrebi odmah dobiti kvalitetnu informaciju.

API

Zahtjev sadrži iste tehničke opcije kao u sinkronom uzorku: `mode`, `rewriteScope` i izborno `qualityHints`.
Klijent obrađuje događaje kao što su `status`, `delta` i `completed` bez izdavanja novih zahtjeva.
Ako je `qualityHints` aktivan, konačna poruka `completed` može sadržavati dodatne savjete o kvaliteti.

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

Asinkroni posao + prozivanje

Prvi zahtjev stvara posao, zatim klijent više puta ispituje status.

Izlaz API

Stvarna obrada je odvojena od prvog HTTP poziva. Pozivni sustav odmah prima ID posla i kasnije se kontrolira kada ponovno upita status.

Naša pozadina prikuplja puno tekstova i kasnije posebno pita koja je varijanta načina rada spremna.

API

`POST` stvara posao i sprema odabranu kombinaciju načina i postavki.
Klijent u intervalima provjerava `GET /api/jobs/{id}` dok se ne prijavi `queued`, `running`, `completed` ili `failed`.
Anketiranje je dobro prilagođeno kada su sažete ili analizirane verzije klasificirane u veće tokove serija.

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

Asinkroni posao + webhook

Prvi zahtjev stvara posao, poruka o završetku vraća se kasnije putem webhooka.

Izlaz API

I ovdje se obrada pokreće asinkrono. Za razliku od anketiranja, klijent ne ispituje status opetovano, već se aktivno obavještava čim rezultat ili pogreška budu dostupni.

Naš CMS odlučuje za svaki sadržaj hoće li se koristiti jednostavan jezik ili jednostavan jezik i sprema samo gotovu verziju nakon webhooka.

API

Uz tehničke podatke, zahtjev za pokretanje također prenosi način rada, postavke i `webhookUrl`.
Po završetku, API šalje potpisani `POST` događaj ciljnom sustavu.
Webhook tokovi posebno su korisni kada se unose različiti načini izlaza u procese objavljivanja ili izdavanja.

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