01
Richiesta HTTP sincrona
Viene inviata una richiesta e la risposta completata ritorna nella stessa connessione HTTP.
Adatto a
Azioni dirette nell'interfaccia, testi brevi e bassa latenza
Dimostrazione
Facile da leggere e da capire: Guarda tutte le impostazioni API in azione.
simple8 trasforma contenuti complessi in testi strutturati e facili da leggere e da capire per chi ha bisogno di un maggiore supporto linguistico. Confronta linguaggio chiaro e linguaggio facile da leggere e da capire, output completo e condensato, suggerimenti sulla qualità opzionali e tutti e quattro i modelli di consegna con esempi di richieste e risposte in tempo reale.
Facile da leggere e da capire
simple8 trasforma contenuti complessi in testi strutturati e facili da leggere e da capire per chi ha bisogno di un maggiore supporto linguistico.
Output in tedesco conformi alle norme DIN
Gli output di simple8 in linguaggio chiaro tedesco sono conformi a DIN ISO 24495-1 e DIN 8581-1. Gli output in linguaggio facile da leggere e da capire sono conformi a DIN SPEC 33429.
CMS, API e widget web con una riga di JavaScript
Integra simple8 con WordPress, TYPO3, Drupal, Storyblok e molti altri sistemi, collegalo tramite API oppure aggiungi il widget al sito con una riga di JavaScript.
Hosting interamente in Germania
simple8 è interamente ospitato e gestito in Germania. L’hosting e il trattamento dei dati sono conformi al GDPR.
SLA di disponibilità mensile del 99,9%
simple8 offre uno SLA di disponibilità mensile del 99,9% per l’API di produzione.
Esempio interattivo
Richiesta e risposta cambiano con ogni impostazione.
Qui puoi vedere direttamente come lavorano insieme linguaggio semplice, linguaggio facile, risposte complete o sintetiche e informazioni opzionali sulla qualità.
Input
Testo di partenza e impostazioni
285 / 1000 caratteri
Modalità
Livello di dettaglio
Richiesta API
{
"text": "Al fine di velocizzare il trattamento, gli utenti devono prima verificare i propri dati personali dopo aver effettuato con successo la registrazione, aggiornarli se necessario e quindi confermare digitalmente il processo. Dopo l'invio, riceverai un messaggio con i passaggi successivi.",
"locale": "it",
"mode": "easy-language",
"settings": {
"rewriteScope": "complete",
"qualityHints": false
}
}Output
Facile da leggere e da capire
Completato940 ms
Dopo l'invio, la traduzione in streaming apparirà qui.
Risposta API
{
"requestId": "simple8_case_01",
"cacheStatus": "hit",
"durationMs": 940,
"locale": "it",
"mode": "easy-language",
"settings": {
"rewriteScope": "complete",
"qualityHints": false
},
"output": {
"text": "Accedi. Controlla le tue informazioni. Modifica le informazioni false direttamente online. Conferma il processo digitalmente. Riceverai quindi un messaggio. Il messaggio contiene i passaggi successivi."
}
}Quattro architetture API
Tutti e quattro i modelli risolvono lo stesso compito tecnico, ma con una logica di trasporto diversa.
La scelta dipende se il risultato è necessario immediatamente, se il progresso deve essere visibile e se il sistema chiamante può attendere attivamente, eseguire il polling o essere avvisato tramite evento.
02
Una richiesta + risposta in streaming
Una richiesta inizia l'elaborazione, la risposta ritorna passo dopo passo come un flusso.
Adatto a
Contenuti più lunghi, interfaccia utente progressiva, avanzamento dell'elaborazione visibile
03
Lavoro asincrono + polling
La prima richiesta crea un lavoro, quindi il client ne interroga ripetutamente lo stato.
Adatto a
Elaborazione batch, backend, lavori più lunghi senza una connessione aperta persistente
04
Lavoro asincrono + webhook
La prima richiesta crea un lavoro, il messaggio di completamento ritorna successivamente tramite un webhook.
Adatto a
Flussi di lavoro CMS, architettura degli eventi, integrazione affidabile da sistema a sistema
I quattro modelli
Concept, realizzazione tecnica ed esempi concreti per ogni architettura.
01
Richiesta HTTP sincrona
Viene inviata una richiesta e la risposta completata ritorna nella stessa connessione HTTP.
Output API
Il sistema chiamante invia una richiesta e attende attivamente il risultato. "mode" e "settings" vengono passati nella stessa richiesta e determinano direttamente la forma della risposta.
Inviamo i testi dei moduli individuali direttamente a simple8 e riceviamo immediatamente la versione linguistica appropriata per la modalità selezionata.
API
- Un `POST /api/translate` con testo, modalità lingua e impostazioni è tipico.
- In caso di successo, l'API restituisce direttamente `200 OK` con il testo semplificato.
- Se `qualityHints=false`, la risposta non contiene ulteriori suggerimenti sulla qualità.
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."
}
}02
Una richiesta + risposta in streaming
Una richiesta inizia l'elaborazione, la risposta ritorna passo dopo passo come un flusso.
Output API
Il client avvia solo una richiesta, ma non rimane cieco fino alla fine. Invece di un'unica risposta finale, ricevono aggiornamenti continui sullo stato o sui contenuti sulla stessa connessione.
La nostra redazione dovrebbe vedere quale versione è attualmente in fase di creazione e, se necessario, ricevere immediatamente le informazioni sulla qualità.
API
- La richiesta contiene le stesse opzioni tecniche del modello sincrono: `mode`, `rewriteScope` e facoltativamente `qualityHints`.
- Il client elabora eventi come `status`, `delta` e `completed` senza emettere nuove richieste.
- Se `qualityHints` è attivo, il messaggio finale `completed` può contenere ulteriori suggerimenti sulla qualità.
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."
]
}
}03
Lavoro asincrono + polling
La prima richiesta crea un lavoro, quindi il client ne interroga ripetutamente lo stato.
Output API
L'elaborazione vera e propria è disaccoppiata dalla prima chiamata HTTP. Il sistema chiamante riceve immediatamente un ID lavoro e successivamente controlla se stesso quando interroga nuovamente lo stato.
Il nostro backend raccoglie molti testi e successivamente chiede specificamente quale variante di modalità è pronta.
API
- Un `POST` crea un lavoro e salva la combinazione selezionata di modalità e impostazioni.
- Il client esegue il polling di `GET /api/jobs/{id}` a intervalli finché non viene segnalato `queued`, `running`, `completed` o `failed`.
- Il polling è particolarmente adatto quando le versioni condensate o analizzate vengono classificate in flussi batch più ampi.
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."
]
}
}04
Lavoro asincrono + webhook
La prima richiesta crea un lavoro, il messaggio di completamento ritorna successivamente tramite un webhook.
Output API
Anche qui l'elaborazione viene avviata in modo asincrono. A differenza del polling, il client non interroga ripetutamente lo stato, ma viene avvisato attivamente non appena è disponibile un risultato o un errore.
Il nostro CMS decide per ogni contenuto se utilizzare il linguaggio semplice o quello facile e salva solo la versione finale dopo il webhook.
API
- Oltre ai dati tecnici, la richiesta di avvio trasmette anche modalità, impostazioni e `webhookUrl`.
- Al termine, l'API invia un evento `POST` firmato al sistema di destinazione.
- I flussi webhook sono particolarmente utili quando si inseriscono diverse modalità di output nei processi di pubblicazione o rilascio.
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."
}
}