Demo

Lectura fácil: Vea cada configuración de API en acción.

simple8 transforma contenidos complejos en lectura fácil estructurada para personas que necesitan un mayor apoyo lingüístico. Compare lenguaje claro y lectura fácil, resultados completos y condensados, sugerencias de calidad opcionales y los cuatro patrones de entrega con ejemplos de solicitudes y respuestas en vivo.

Lectura fácil

simple8 transforma contenidos complejos en lectura fácil estructurada para personas que necesitan un mayor apoyo lingüístico.

Resultados en alemán conformes con DIN

Los resultados de simple8 en lenguaje claro alemán cumplen DIN ISO 24495-1 y DIN 8581-1. Los resultados en lectura fácil alemana cumplen DIN SPEC 33429.

CMS, API y widget web con una línea de JavaScript

Integre simple8 con WordPress, TYPO3, Drupal, Storyblok y muchos otros sistemas, conéctelo mediante la API o añada el widget web con una línea de JavaScript.

Alojamiento íntegramente en Alemania

simple8 se aloja y opera por completo en Alemania. El alojamiento y el tratamiento de datos cumplen el RGPD.

SLA de disponibilidad mensual del 99,9 %

simple8 ofrece un SLA de disponibilidad mensual del 99,9 % para la API de producción.

Ir a la descripción general de la arquitectura integración web

Ejemplo interactivo

La solicitud y la respuesta cambian con cada configuración.

Aquí puede ver directamente cómo funcionan juntos el lenguaje simple, el lenguaje fácil, las respuestas completas o condensadas y la información de calidad opcional.

Entrada

Texto de origen y ajustes

Texto de origen

259 / 1000 caracteres

Modo

Nivel de detalle

Indicaciones de calidadAgrega información de calidad adicional a la respuesta de la API. Sin esta configuración, la respuesta sólo proporciona el resultado.

Solicitud API

{
  "text": "Para acelerar el procesamiento, los usuarios primero deben verificar su información personal después del registro exitoso, actualizarla si es necesario y luego confirmar el proceso digitalmente. Después de enviar, recibirá un mensaje con los siguientes pasos.",
  "locale": "es",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Salida

Lectura fácil

Completado940 ms

Después del envío, la traducción transmitida aparecerá aquí.

Respuesta API

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "es",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Inicia sesión. Verifica tu información. Cambie información falsa directamente en línea. Confirma el proceso digitalmente. Luego recibirás un mensaje. El mensaje contiene los siguientes pasos."
  }
}

Cuatro arquitecturas API

Los cuatro patrones resuelven la misma tarea técnica, pero con una lógica de transporte diferente.

La elección depende de si el resultado se necesita de inmediato, si el progreso debe ser visible y si el sistema de llamadas puede esperar activamente, sondear o recibir una notificación mediante un evento.

Solicitud HTTP sincrónica

Se ingresa una solicitud y la respuesta finalizada regresa en la misma conexión HTTP.

Adecuado para

Acciones directas en la interfaz, textos cortos y baja latencia

Una solicitud + respuesta en streaming

Una solicitud comienza a procesarse, la respuesta regresa paso a paso como una secuencia.

Adecuado para

Contenido más extenso, interfaz de usuario progresiva, progreso de procesamiento visible

Trabajo asíncrono + sondeo

La primera solicitud crea un trabajo, luego el cliente consulta el estado repetidamente.

Adecuado para

Procesamiento por lotes, backends, trabajos más largos sin una conexión abierta persistente

Trabajo asíncrono + webhook

La primera solicitud crea un trabajo, el mensaje de finalización aparece más tarde a través de un webhook.

Adecuado para

Flujos de trabajo CMS, arquitectura de eventos, integración confiable de sistema a sistema

Los cuatro patrones

Concepto, implementación técnica y ejemplos concretos para cada arquitectura.

Solicitud HTTP sincrónica

Se ingresa una solicitud y la respuesta finalizada regresa en la misma conexión HTTP.

Salida API

El sistema que realiza la llamada envía una solicitud y espera activamente el resultado. `mode` y `settings` se transmiten en la misma solicitud y determinan directamente la forma de la respuesta.

Enviamos textos de formularios individuales directamente a simple8 y recibimos inmediatamente la versión de idioma adecuada para el modo seleccionado.

API

Es típico un `POST /api/translate` con texto, modo de idioma y configuración.
Si tiene éxito, la API devuelve directamente `200 OK` con el texto simplificado.
Si `qualityHints=false`, la respuesta no contiene sugerencias de calidad adicionales.

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

Una solicitud + respuesta en streaming

Una solicitud comienza a procesarse, la respuesta regresa paso a paso como una secuencia.

Salida API

El cliente solo inicia una solicitud, pero no permanece ciego hasta el final. En lugar de una única respuesta final, reciben actualizaciones continuas de estado o contenido a través de la misma conexión.

Nuestro equipo editorial debería ver qué versión se está creando actualmente y, si es necesario, recibir inmediatamente la información de calidad.

API

La solicitud contiene las mismas opciones técnicas que en el patrón sincrónico: `mode`, `rewriteScope` y opcionalmente `qualityHints`.
El cliente procesa eventos como `status`, `delta` y `completed` sin enviar nuevas solicitudes.
Cuando `qualityHints` está activo, el mensaje final `completed` puede incluir indicaciones de calidad adicionales.

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

Trabajo asíncrono + sondeo

La primera solicitud crea un trabajo, luego el cliente consulta el estado repetidamente.

Salida API

El procesamiento real está desacoplado de la primera llamada HTTP. El sistema que llama recibe inmediatamente un ID de trabajo y luego se controla cuando vuelve a consultar el estado.

Nuestro backend recopila muchos textos y luego pregunta específicamente qué variante de modo está lista.

API

Una `POST` crea un trabajo y guarda la combinación seleccionada de modo y configuración.
El cliente consulta `GET /api/jobs/{id}` a intervalos hasta que se informa el estado `queued`, `running`, `completed` o `failed`.
El sondeo es muy adecuado cuando las versiones condensadas o analizadas se clasifican en flujos por lotes más grandes.

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

Trabajo asíncrono + webhook

La primera solicitud crea un trabajo, el mensaje de finalización aparece más tarde a través de un webhook.

Salida API

También en este caso el procesamiento se inicia de forma asincrónica. A diferencia del sondeo, el cliente no consulta el estado repetidamente, sino que recibe una notificación activa tan pronto como hay un resultado o error disponible.

Nuestro CMS decide para cada contenido si se utiliza un lenguaje sencillo o un lenguaje sencillo y solo guarda la versión final después del webhook.

API

Además de los datos técnicos, la solicitud de inicio también transmite el modo, la configuración y `webhookUrl`.
Al finalizar, la API envía un evento `POST` firmado al sistema de destino.
Los flujos de webhook son particularmente útiles cuando se introducen diferentes modos de salida en procesos de publicación o lanzamiento.

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