Referência à API
Simplifique e traduza conteúdo em 24 idiomas de saída.
O ponto final síncrono aceita texto de origem, uma localidade de saída e um de dois modos. Ele detecta o idioma de origem automaticamente e retorna um resultado pronto para uso no idioma de saída selecionado.
{
"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
Crie um resultado em Linguagem Simples ou Linguagem Fácil e retorne-o na mesma resposta HTTP.
Títulos necessários
| Título | Valor | Propósito |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentica o projeto com o esquema HTTP Bearer atual |
| Content-Type | Aplicação/json | Declare o formato do corpo da solicitação |
| Accept | Aplicação/json | Requer uma resposta JSON |
| Idempotency-Key | Obrigatório apenas para trabalhos e lotes | Evita que envios assíncronos repetidos criem trabalhos duplicados |
Ó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. | 1 a 10.000 caracteres Unicode | Conteúdo de fonte no local selecionado |
| locale | linha | Sim, sim. | Um dos 24 códigos de duas letras suportados | Idioma de saída. O idioma de origem é detectado automaticamente. |
| mode | linha | Sim, sim. | Língua simples, fácil de falar | Modo de simplificação |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Organismo de resposta
A resposta não deve conter configurações de solicitação descontinuadas ou uma matriz separada de informações de qualidade.
| Campo | Tipo | Descrição |
|---|---|---|
| requestId | linha | Identificador único para o suporte e os registos |
| locale | linha | Local de saída selecionado |
| mode | linha | Modo de simplificação selecionado |
| output | linha | Resultado finalizado no local de saída selecionado |
| 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 30 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
- Texto faltante: rejeitar com um erro de campo documentado.
- Texto vazio: rejeitar com um erro de campo documentado.
- Local não suportado: rejeitar; nunca substituir silenciosamente outro local.
- Modo não suportado: rejeitar; nunca escolher um modo automaticamente.
- Campo retirado desconhecido: rejeitar com um erro centrado na migração ou lidar apenas através de uma camada de compatibilidade explicitamente versão.
- O texto fonte pode usar um idioma diferente do local. Simple8 detecta o idioma de origem automaticamente e grava o resultado no local de saída selecionado.