Démo

FALC: Découvrez chaque paramètre d'API en action.

simple8 transforme les contenus complexes en FALC structuré pour les personnes qui ont besoin d’un soutien linguistique renforcé. Comparez langage clair et FALC, une sortie complète et condensée, des conseils de qualité facultatifs et les quatre modèles de livraison avec des exemples de demandes et de réponses en direct.

FALC

simple8 transforme les contenus complexes en FALC structuré pour les personnes qui ont besoin d’un soutien linguistique renforcé.

Résultats en allemand conformes aux normes DIN

Les résultats de simple8 en langage clair allemand sont conformes à DIN ISO 24495-1 et DIN 8581-1. Les résultats en FALC allemand sont conformes à DIN SPEC 33429.

CMS, API et widget web avec une ligne de JavaScript

Intégrez simple8 à WordPress, TYPO3, Drupal, Storyblok et bien d’autres systèmes, connectez-le par API ou ajoutez le widget au site avec une ligne de JavaScript.

Hébergement intégral en Allemagne

simple8 est entièrement hébergé et exploité en Allemagne. L’hébergement et le traitement des données sont conformes au RGPD.

SLA de disponibilité mensuelle de 99,9 %

simple8 fournit un SLA de disponibilité mensuelle de 99,9 % pour l’API de production.

Accédez à l'aperçu de l'architecture intégration site web

Exemple interactif

La demande et la réponse changent à chaque paramètre.

Ici, vous pouvez voir directement comment un langage simple, un langage facile, des réponses complètes ou condensées et des informations facultatives sur la qualité fonctionnent ensemble.

Entrée

Texte source et paramètres

Texte source

290 / 1000 caractères

Mode

Niveau de détail

Notes de qualitéAjoute des informations de qualité supplémentaires à la réponse de l'API. Sans ce paramètre, la réponse fournit uniquement le résultat.

Requête API

{
  "text": "Afin d'accélérer le traitement, les utilisateurs doivent d'abord vérifier leurs informations personnelles après une inscription réussie, les mettre à jour si nécessaire puis confirmer le processus par voie numérique. Après la soumission, vous recevrez un message avec les prochaines étapes.",
  "locale": "fr",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Sortie

FALC

Terminé940 ms

Après l'envoi, la traduction en streaming apparaîtra ici.

Réponse API

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "fr",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Connectez-vous. Vérifiez vos informations. Modifiez les fausses informations directement en ligne. Confirmez le processus numériquement. Vous recevrez alors un message. Le message contient les étapes suivantes."
  }
}

Quatre architectures API

Les quatre modèles résolvent la même tâche technique, mais avec une logique de transport différente.

Le choix dépend si le résultat est nécessaire immédiatement, si la progression doit être visible et si le système appelant peut activement attendre, interroger ou être averti via un événement.

Requête HTTP synchrone

Une requête arrive et la réponse terminée revient dans la même connexion HTTP.

Convient pour

Actions directes dans l'interface, textes courts et faible latence

Une requête + réponse en streaming

Une requête commence à être traitée, la réponse revient étape par étape sous forme de flux.

Convient pour

Contenu plus long, interface utilisateur progressive, progression du traitement visible

Travail asynchrone + sondage

La première requête crée un travail, puis le client interroge le statut à plusieurs reprises.

Convient pour

Traitement par lots, backends, tâches plus longues sans connexion ouverte persistante

Tâche asynchrone + webhook

La première requête crée un job, le message de fin revient plus tard via un webhook.

Convient pour

Workflows CMS, architecture d'événements, intégration système à système fiable

Les quatre modèles

Concept, mise en œuvre technique et exemples concrets pour chaque architecture.

Requête HTTP synchrone

Une requête arrive et la réponse terminée revient dans la même connexion HTTP.

Sortie API

Le système appelant envoie une requête et attend activement le résultat. `mode` et `settings` sont transmis dans la même requête et déterminent directement la forme de la réponse.

Nous envoyons des textes de formulaire individuels directement à simple8 et recevons immédiatement la version linguistique appropriée pour le mode sélectionné.

API

Un `POST /api/translate` avec texte, mode de langue et paramètres est typique.
En cas de succès, l'API renvoie directement `200 OK` avec le texte simplifié.
Si `qualityHints=false`, la réponse ne contient pas d'indices de qualité supplémentaires.

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

Une requête + réponse en streaming

Une requête commence à être traitée, la réponse revient étape par étape sous forme de flux.

Sortie API

Le client ne démarre qu'une seule requête, mais ne reste pas aveugle jusqu'à la fin. Au lieu d’une réponse finale unique, ils reçoivent des mises à jour continues de statut ou de contenu via la même connexion.

Notre équipe éditoriale doit voir quelle version est en cours de création et, si nécessaire, recevoir immédiatement les informations de qualité.

API

La requête contient les mêmes options techniques que dans le modèle synchrone : `mode`, `rewriteScope` et éventuellement `qualityHints`.
Le client traite des événements tels que `status`, `delta` et `completed` sans envoyer de nouvelles requêtes.
Si `qualityHints` est actif, le message final `completed` peut contenir des conseils de qualité supplémentaires.

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

Travail asynchrone + sondage

La première requête crée un travail, puis le client interroge le statut à plusieurs reprises.

Sortie API

Le traitement réel est découplé du premier appel HTTP. Le système appelant reçoit immédiatement un ID de tâche et se contrôle ensuite lorsqu'il interroge à nouveau l'état.

Notre backend collecte de nombreux textes et demande plus tard spécifiquement quelle variante de mode est prête.

API

Un `POST` crée une tâche et enregistre la combinaison sélectionnée de mode et de paramètres.
Le client interroge `GET /api/jobs/{id}` à intervalles jusqu'à ce que `queued`, `running`, `completed` ou `failed` soit signalé.
L'interrogation est bien adaptée lorsque les versions condensées ou analysées sont classées en flux de lots plus importants.

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

Tâche asynchrone + webhook

La première requête crée un job, le message de fin revient plus tard via un webhook.

Sortie API

Ici aussi, le traitement est démarré de manière asynchrone. Contrairement à l'interrogation, le client n'interroge pas l'état à plusieurs reprises, mais est activement averti dès qu'un résultat ou une erreur est disponible.

Notre CMS décide pour chaque contenu si un langage simple ou un langage facile est utilisé et n'enregistre la version finale qu'après le webhook.

API

En plus des données techniques, la demande de démarrage transmet également le mode, les paramètres et `webhookUrl`.
Une fois terminé, l'API envoie un événement `POST` signé au système cible.
Les flux Webhook sont particulièrement utiles pour introduire différents modes de sortie dans les processus de publication ou de publication.

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