Documentação

Escolha como o seu sistema recebe o resultado.

{
  "text": "Conteúdo de origem complexo no idioma selecionado.",
  "locale": "pt",
  "mode": "simple-language"
}

Exemplos de SDK e cURL disponíveis

HTTP sincrono

Cada padrão usa os mesmos campos principais: texto, localidade e modo.

Ponto final

POST /api/v2/translate

Melhor para

Conteúdo curto e ações directas de backend.

Sucesso

200 OK

Transmissão

A resposta usa Content-Type: text/event-stream.

Ponto final

POST /api/v2/translate/stream

Melhor para

Interfaces progressivas e conteúdo mais longo.

{
  "text": "Source content in the selected language.",
  "locale": "en",
  "mode": "easy-language"
}

event: meta
data: {"requestId":"req_stream_001","locale":"en","mode":"easy-language"}

event: delta
data: {"delta":"Complete result."}

event: done
data: {"usage":{"inputCharacters":42,"cacheHit":false}}

O fluxo emite um evento meta, um ou mais eventos delta e um evento final concluído.

O metaevento contém o identificador da solicitação, a localidade e o modo.

Cada delta contém uma parte do resultado e pronto contém as informações de uso.

Depois de feito isso, a conexão é fechada.

Trabalho sincronizado com as pesquisas

Envie um cabeçalho Idempotency-Key exclusivo ao criar um trabalho.

Criar um ponto final

POST /api/v2/jobs

Ponto final de status

GET /api/v2/jobs/{id}

{
  "text": "Source content in the selected language.",
  "locale": "fr",
  "mode": "simple-language",
  "delivery": {
    "type": "polling"
  }
}

{
  "jobId": "job_poll_001",
  "status": "queued"
}

{
  "jobId": "job_poll_001",
  "status": "completed",
  "locale": "fr",
  "mode": "simple-language",
  "output": {
    "text": "Simplified content in French."
  }
}

As vagas permanecem disponíveis por sete dias.

Pesquise em um intervalo razoável até que o status seja concluído ou falhe.

Trabalho de sincronização com webhook

Crie e verifique primeiro um endpoint de webhook no aplicativo Simple8. Em seguida, faça referência ao ID do endpoint no trabalho.

Criar um ponto final

POST /api/v2/jobs

{
  "text": "Source content in the selected language.",
  "locale": "de",
  "mode": "easy-language",
  "delivery": {
    "type": "webhook",
    "endpointId": "00000000-0000-4000-8000-000000000000"
  }
}

{
  "id": "evt_01",
  "type": "job.completed",
  "createdAt": "2026-08-06T12:00:00.000Z",
  "data": {
    "jobId": "job_hook_001",
    "status": "completed"
  }
}

Simple8 envia um cabeçalho Simple8-Signature com um carimbo de data/hora e uma assinatura HMAC SHA-256.

Verifique a assinatura no corpo da solicitação bruta com o segredo de assinatura mostrado uma vez quando o endpoint é criado.

Retorne qualquer status 2xx após aceitar o evento.

As entregas com falha são repetidas até 50 vezes ao longo de sete dias, e as tentativas recentes ficam visíveis no aplicativo.

Os destinatários devem tolerar a entrega duplicada porque as novas tentativas podem entregar o mesmo evento mais de uma vez.

Processamento em lote

Envie entre 1 e 50 itens com um máximo combinado de 500.000 caracteres.

Criar um ponto final

POST /api/v2/batches

Ponto final de status

GET /api/v2/batches/{id}

Cada item usa os mesmos campos de texto, localidade e modo que uma solicitação síncrona.

Escolha a sondagem ou um endpoint de webhook verificado para entrega e envie um cabeçalho Idempotency-Key exclusivo.

Nesta página