API para linguagem clara e linguagem fácil.
Envie seu texto fonte, o idioma alvo desejado e um dos dois modos de linguagem. Simple8 reconhece automaticamente a língua de origem e retorna o texto finalizado na língua de destino.
{
"text": "Conteúdo de origem complexo no idioma selecionado.",
"locale": "pt",
"mode": "simple-language"
}Exemplos de SDK e cURL disponíveis
Ponto final
POST /api/v2/translate
Cria um texto em linguagem simples ou fácil e retorna-o diretamente na resposta HTTP.
Títulos necessários
| Título | Valor | Propósito |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autenticação do espaço de trabalho |
| Content-Type | Aplicação/json | Indica que o pedido contém JSON |
| Accept | Aplicação/json | Requer uma resposta JSON |
| Idempotency-Key | Só é necessário para as encomendas de base e a granel | Previne ordens de fundo duplicadas |
Órgão de pedido
Nenhuma outra configuração de conteúdo faz parte do esquema de solicitação pública.
| Campo | Tipo | Requerido | Valor permitido | Descrição |
|---|---|---|---|---|
| text | linha | Sim, sim. | De 1 a 5.000 pontos de código Unicode normalizados com NFC | Texto de origem |
| locale | linha | Sim, sim. | Um dos 136 códigos suportados de 2 ou 3 letras | Idioma de saída. O idioma de origem é detectado automaticamente. |
| mode | linha | Sim, sim. | simple-language, easy-language | Modo de simplificação |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Organismo de resposta
A resposta contém o texto acabado e os dados de uso documentados.
| Campo | Tipo | Descrição |
|---|---|---|
| requestId | linha | Identificador único para o suporte e os registos |
| locale | linha | Língua de destino selecionada |
| mode | linha | Modo de simplificação selecionado |
| output | linha | Preparar o texto na língua de destino seleccionada |
| usage.inputCharacters | número inteiro | Caracteres contados para esta solicitação ou 0 para uma ocorrência no cache |
| usage.cacheHit | booleano | Se o resultado veio do cache de 180 dias |
{
"requestId": "req_sync_002",
"locale": "en",
"mode": "easy-language",
"output": "You need to send documents.\nSend the documents before the deadline.",
"usage": {
"inputCharacters": 78,
"cacheHit": false
}
}Comportamento de validação
- Os campos em falta, vazios, desconhecidos ou inválidos devolvem HTTP 400 com o código de erro invalid_request e os detalhes de validação.
- O comprimento do texto é medido em pontos de código Unicode após a normalização NFC.
- A configuração regional tem de ser um dos 136 códigos documentados de 2 ou 3 letras.
- O modo tem de ser exatamente simple-language ou easy-language.
- Simple8 reconhece automaticamente a linguagem do texto fonte e cria o resultado na língua alvo selecionada.