Demonstração

Leitura fácil: Veja todas as configurações da API em ação.

A simple8 transforma conteúdos complexos em Leitura Fácil estruturada para pessoas que necessitam de maior apoio linguístico. Compare linguagem simples e Leitura Fácil, saída completa e condensada, dicas de qualidade opcionais e todos os quatro padrões de entrega com exemplos de solicitação e resposta ao vivo.

Leitura fácil

A simple8 transforma conteúdos complexos em Leitura Fácil estruturada para pessoas que necessitam de maior apoio linguístico.

Resultados em alemão conformes às normas DIN

Os resultados da simple8 em linguagem simples alemã estão em conformidade com a DIN ISO 24495-1 e a DIN 8581-1. Os resultados em Leitura Fácil em alemão estão em conformidade com a DIN SPEC 33429.

CMS, API e widget para websites com uma linha de JavaScript

Integre a simple8 com WordPress, TYPO3, Drupal, Storyblok e muitos outros sistemas, ligue-a através da API ou adicione o widget ao website com uma linha de JavaScript.

Alojamento integral na Alemanha

A simple8 está integralmente alojada e é operada na Alemanha. O alojamento e o tratamento de dados cumprem o RGPD.

SLA de disponibilidade mensal de 99,9%

A simple8 fornece um SLA de disponibilidade mensal de 99,9% para a API de produção.

Vá para a visão geral da arquitetura integração em websites

Exemplo interativo

Solicitação e resposta mudam com cada configuração.

Aqui você pode ver diretamente como a linguagem simples, a linguagem fácil, as respostas completas ou condensadas e as informações opcionais de qualidade funcionam juntas.

Entrada

Texto de origem e definições

Texto de origem

258 / 1000 caracteres

Modo

Nível de detalhe

Notas de qualidadeAdiciona informações adicionais de qualidade à resposta da API. Sem essa configuração, a resposta fornece apenas o resultado.

Pedido API

{
  "text": "Para agilizar o processamento, os usuários devem primeiro verificar suas informações pessoais após o registro bem-sucedido, atualizá-las se necessário e depois confirmar o processo digitalmente. Após enviar, você receberá uma mensagem com os próximos passos.",
  "locale": "pt",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Saída

Leitura fácil

Concluído940 ms

Após o envio, a tradução transmitida aparecerá aqui.

Resposta API

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "pt",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Faça login. Verifique suas informações. Altere informações falsas diretamente online. Confirme o processo digitalmente. Você receberá então uma mensagem. A mensagem contém as próximas etapas."
  }
}

Quatro arquiteturas de API

Todos os quatro padrões resolvem a mesma tarefa técnica, mas com lógica de transporte diferente.

A escolha depende se o resultado é necessário imediatamente, se o progresso deve ser visível e se o sistema chamador pode esperar ativamente, pesquisar ou ser notificado via evento.

Solicitação HTTP síncrona

Uma solicitação entra e a resposta finalizada retorna na mesma conexão HTTP.

Adequado para

Ações diretas na interface, textos curtos e baixa latência

Uma solicitação + resposta de streaming

Uma solicitação inicia o processamento, a resposta volta passo a passo como um fluxo.

Adequado para

Conteúdo mais longo, UI progressiva, progresso de processamento visível

Trabalho assíncrono + pesquisa

A primeira solicitação cria um trabalho, então o cliente consulta o status repetidamente.

Adequado para

Processamento em lote, backends, trabalhos mais longos sem uma conexão aberta persistente

Trabalho assíncrono + webhook

A primeira solicitação cria um trabalho, a mensagem de conclusão retorna posteriormente por meio de um webhook.

Adequado para

Fluxos de trabalho CMS, arquitetura de eventos, integração confiável de sistema para sistema

Os quatro padrões

Conceito, implementação técnica e exemplos concretos para cada arquitetura.

Solicitação HTTP síncrona

Uma solicitação entra e a resposta finalizada retorna na mesma conexão HTTP.

Saída API

O sistema chamador envia uma solicitação e aguarda ativamente pelo resultado. `mode` e `settings` são passados na mesma solicitação e determinam diretamente a forma da resposta.

Enviamos textos de formulários individuais diretamente para simple8 e recebemos imediatamente a versão no idioma apropriado para o modo selecionado.

API

Um `POST /api/translate` com texto, modo de idioma e configurações é típico.
Se for bem-sucedido, a API retornará diretamente `200 OK` com o texto simplificado.
Se `qualityHints=false`, a resposta não contém dicas de qualidade adicionais.

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

Uma solicitação + resposta de streaming

Uma solicitação inicia o processamento, a resposta volta passo a passo como um fluxo.

Saída API

O cliente inicia apenas uma solicitação, mas não permanece cego até o final. Em vez de uma única resposta final, eles recebem atualizações contínuas de status ou conteúdo pela mesma conexão.

Nossa equipe editorial deverá ver qual versão está sendo criada e, se necessário, receber imediatamente a informação de qualidade.

API

A solicitação contém as mesmas opções técnicas do padrão síncrono: `mode`, `rewriteScope` e opcionalmente `qualityHints`.
O cliente processa eventos como `status`, `delta` e `completed` sem emitir novas solicitações.
Se `qualityHints` estiver ativo, a mensagem final `completed` pode conter dicas de qualidade adicionais.

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

Trabalho assíncrono + pesquisa

A primeira solicitação cria um trabalho, então o cliente consulta o status repetidamente.

Saída API

O processamento real é desacoplado da primeira chamada HTTP. O sistema chamador recebe imediatamente um ID de trabalho e posteriormente se controla quando consulta o status novamente.

Nosso backend coleta muitos textos e depois pergunta especificamente qual variante de modo está pronta.

API

Um `POST` cria um trabalho e salva a combinação selecionada de modo e configurações.
O cliente pesquisa `GET /api/jobs/{id}` em intervalos até que `queued`, `running`, `completed` ou `failed` seja relatado.
A votação é adequada quando versões condensadas ou analisadas são classificadas em fluxos de lote maiores.

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

Trabalho assíncrono + webhook

A primeira solicitação cria um trabalho, a mensagem de conclusão retorna posteriormente por meio de um webhook.

Saída API

Aqui também o processamento é iniciado de forma assíncrona. Ao contrário da sondagem, o cliente não consulta o status repetidamente, mas é notificado ativamente assim que um resultado ou erro estiver disponível.

Nosso CMS decide para cada conteúdo se será usada linguagem simples ou linguagem fácil e só salva a versão finalizada após o webhook.

API

Além dos dados técnicos, a solicitação de início também transmite modo, configurações e `webhookUrl`.
Após a conclusão, a API envia um evento `POST` assinado para o sistema de destino.
Os fluxos de webhook são particularmente úteis ao alimentar diferentes modos de saída em processos de publicação ou lançamento.

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