Demo

Ușor de citit și de înțeles: Vedeți fiecare setare API în acțiune.

simple8 transformă conținutul complex într-un text structurat și ușor de citit și de înțeles pentru persoanele care au nevoie de sprijin lingvistic sporit. Comparați limbaj clar și ușor de citit și de înțeles, rezultate complete și condensate, indicii opționale de calitate și toate cele patru modele de livrare cu exemple live de solicitare și răspuns.

Ușor de citit și de înțeles

simple8 transformă conținutul complex într-un text structurat și ușor de citit și de înțeles pentru persoanele care au nevoie de sprijin lingvistic sporit.

Rezultate în limba germană conforme cu standardele DIN

Rezultatele simple8 în limbaj clar german sunt conforme cu DIN ISO 24495-1 și DIN 8581-1. Rezultatele în limbaj german ușor de citit și de înțeles sunt conforme cu DIN SPEC 33429.

CMS, API și widget pentru website cu o singură linie de JavaScript

Integrați simple8 cu WordPress, TYPO3, Drupal, Storyblok și multe alte sisteme, conectați-l prin API ori adăugați widgetul pe website cu o singură linie de JavaScript.

Găzduire integrală în Germania

simple8 este găzduit și operat integral în Germania. Găzduirea și prelucrarea datelor respectă GDPR.

SLA de disponibilitate lunară de 99,9%

simple8 oferă un SLA de disponibilitate lunară de 99,9% pentru API-ul de producție.

Salt la prezentarea generală a arhitecturii integrare în website

Exemplu interactiv

Solicitarea și răspunsul se modifică cu fiecare setare.

Aici puteți vedea direct modul în care limbajul simplu, limbajul ușor, răspunsurile complete sau condensate și informațiile de calitate opționale funcționează împreună.

Intrare

Text sursă și setări

Text sursă

258 / 1000 caractere

Mod

Nivel de detaliu

Note privind calitateaAdaugă informații de calitate suplimentare la răspunsul API. Fără această setare, răspunsul oferă doar rezultatul.

Cerere API

{
  "text": "Pentru a accelera procesarea, utilizatorii trebuie mai întâi să își verifice informațiile personale după înregistrarea cu succes, să le actualizeze dacă este necesar și apoi să confirme digital procesul. După trimitere, veți primi un mesaj cu pașii următori.",
  "locale": "ro",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Ieșire

Ușor de citit și de înțeles

Finalizat940 ms

După trimitere, traducerea transmisă în flux va apărea aici.

Răspuns API

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "ro",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Conectați-vă. Verificați-vă informațiile. Schimbați informațiile false direct online. Confirmați procesul digital. Veți primi apoi un mesaj. Mesajul conține următorii pași."
  }
}

Patru arhitecturi API

Toate cele patru modele rezolvă aceeași sarcină tehnică, dar cu o logică de transport diferită.

Alegerea depinde dacă rezultatul este necesar imediat, dacă progresul ar trebui să fie vizibil și dacă sistemul de apelare poate aștepta, interoga sau poate fi notificat prin eveniment.

Solicitare HTTP sincronă

O solicitare intră și răspunsul final revine în aceeași conexiune HTTP.

Potrivit pentru

Acțiuni directe în interfață, texte scurte și latență redusă

O cerere + răspuns în flux

O solicitare începe procesarea, răspunsul revine pas cu pas ca un flux.

Potrivit pentru

Conținut mai lung, interfață de utilizare progresivă, progres vizibil de procesare

Lucrare asincronă + sondaj

Prima solicitare creează un job, apoi clientul interogează starea în mod repetat.

Potrivit pentru

Procesare în loturi, backend-uri, joburi mai lungi fără o conexiune deschisă persistentă

Lucrare asincronă + webhook

Prima solicitare creează un job, mesajul de finalizare revine mai târziu printr-un webhook.

Potrivit pentru

Fluxuri de lucru CMS, arhitectură de evenimente, integrare fiabilă de la sistem la sistem

Cele patru modele

Concept, implementare tehnică și exemple concrete pentru fiecare arhitectură.

Solicitare HTTP sincronă

O solicitare intră și răspunsul final revine în aceeași conexiune HTTP.

Ieșire API

Sistemul de apelare trimite o solicitare și așteaptă activ rezultatul. `mode` și `settings` sunt transmise în aceeași cerere și determină direct forma răspunsului.

Trimitem texte individuale de formular direct către simple8 și primim imediat versiunea lingvistică corespunzătoare pentru modul selectat.

API

O „POST /api/translate” cu text, mod de limbă și setări este tipică.
Dacă reușește, API-ul returnează direct `200 OK` cu textul simplificat.
Dacă `qualityHints=false`, răspunsul nu conține indicii de calitate suplimentare.

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

O cerere + răspuns în flux

O solicitare începe procesarea, răspunsul revine pas cu pas ca un flux.

Ieșire API

Clientul începe o singură cerere, dar nu rămâne orb până la final. În loc de un singur răspuns final, ei primesc actualizări permanente de stare sau de conținut prin aceeași conexiune.

Echipa noastră editorială ar trebui să vadă ce versiune este creată în prezent și, dacă este necesar, să primească imediat informațiile de calitate.

API

Solicitarea conține aceleași opțiuni tehnice ca și în modelul sincron: `mode`, `rewriteScope` și opțional `qualityHints`.
Clientul procesează evenimente precum `status`, `delta` și `completed` fără a trimite cereri noi.
Dacă `qualityHints` este activ, mesajul final `completed` poate conține indicii suplimentare de calitate.

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

Lucrare asincronă + sondaj

Prima solicitare creează un job, apoi clientul interogează starea în mod repetat.

Ieșire API

Procesarea efectivă este decuplată de primul apel HTTP. Sistemul apelant primește imediat un ID de job și mai târziu se controlează atunci când solicită din nou starea.

Backend-ul nostru colectează o mulțime de texte și mai târziu întreabă în mod specific ce variantă de mod este gata.

API

O „POST” creează o lucrare și salvează combinația selectată de mod și setări.
Clientul interogează `GET /api/jobs/{id}` la intervale până când este raportat `queued`, `running`, `completed` sau `failed`.
Sondajul este potrivit atunci când versiunile condensate sau analizate sunt clasificate în fluxuri de loturi mai mari.

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

Lucrare asincronă + webhook

Prima solicitare creează un job, mesajul de finalizare revine mai târziu printr-un webhook.

Ieșire API

Și aici, procesarea este începută asincron. Spre deosebire de sondaj, clientul nu interogă starea în mod repetat, ci este notificat activ de îndată ce este disponibilă un rezultat sau o eroare.

CMS-ul nostru decide pentru fiecare conținut dacă se folosește un limbaj simplu sau un limbaj ușor și salvează versiunea finală numai după webhook.

API

Pe lângă datele tehnice, cererea de pornire transmite și modul, setările și `webhookUrl`.
La finalizare, API-ul trimite un eveniment `POST` semnat sistemului țintă.
Fluxurile Webhook sunt deosebit de utile atunci când introduc diferite moduri de ieșire în procesele de publicare sau lansare.

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