Referencia de la API
Simplifique y traduzca contenido a 24 idiomas de salida.
El punto final síncrono acepta texto fuente, una configuración regional de salida y uno de dos modos. Detecta el idioma de origen automáticamente y devuelve un resultado listo para usar en el idioma de salida seleccionado.
{
"text": "Contenido fuente complejo en el idioma seleccionado.",
"locale": "es",
"mode": "simple-language"
}Ejemplos de SDK y cURL disponibles
Punto final
POST /api/v2/translate
Cree un resultado en lenguaje sencillo o lenguaje fácil y devuélvalo en la misma respuesta HTTP.
Las cabeceras requeridas
| Título | El valor | Propósito |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentica el proyecto con el esquema de portador HTTP actual. |
| Content-Type | solicitud/json | Declarará el formato del cuerpo de la solicitud |
| Accept | solicitud/json | Requiere una respuesta JSON |
| Idempotency-Key | Requerido solo para trabajos y lotes | Evita que los envíos asincrónicos repetidos creen trabajo duplicado |
Organismo de solicitud
Ninguna otra configuración de contenido forma parte del esquema de solicitud pública.
| Campo de trabajo | Tipo de producto | Requerido | Valor permitido | Descripción |
|---|---|---|---|---|
| text | cuerdas | Sí , es cierto . | 1 a 10.000 caracteres Unicode | Contenido de origen en la ubicación seleccionada |
| locale | cuerdas | Sí , es cierto . | Uno de los 24 códigos de dos letras compatibles | Idioma de salida. El idioma de origen se detecta automáticamente. |
| mode | cuerdas | Sí , es cierto . | lenguaje simple, lenguaje fácil | Modo de simplificación |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Organismo de respuesta
La respuesta no debe contener configuraciones de solicitud retiradas ni una matriz de información de calidad separada.
| Campo de trabajo | Tipo de producto | Descripción |
|---|---|---|
| requestId | cuerdas | Identificador único para soporte y registros |
| locale | cuerdas | Configuración regional de salida seleccionada |
| mode | cuerdas | Modo de simplificación seleccionado |
| output | cuerdas | Resultado final en la configuración regional de salida seleccionada |
| usage.inputCharacters | número entero | Caracteres contados para esta solicitud o 0 para un acierto de caché |
| usage.cacheHit | booleano | Si el resultado provino del caché de 30 días |
{
"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
}
}El comportamiento de validación
- Texto faltante: rechazar con un error de campo documentado.
- Texto vacío: rechazar con un error de campo documentado.
- Local no soportado: rechazar; nunca sustituir silenciosamente a otra localidad.
- Modo no soportado: rechazar; nunca elija un modo automáticamente.
- Campo retirado desconocido: rechazar con un error centrado en la migración o manejar solo a través de una capa de compatibilidad con versión explícita.
- El texto fuente puede utilizar un idioma diferente al local. Simple8 detecta el idioma de origen automáticamente y escribe el resultado en la configuración regional de salida seleccionada.