Cada patrón utiliza los mismos campos principales: texto, configuración regional y modo.
Elige cómo recibe el resultado tu sistema.
{
"text": "Contenido fuente complejo en el idioma seleccionado.",
"locale": "es",
"mode": "simple-language"
}Ejemplos de SDK y cURL disponibles
HTTP sincrono
Punto final
POST /api/v2/translate
Lo mejor para
Contenido corto y acciones directas de backend.
El éxito
200 Está bien
En streaming
La respuesta utiliza tipo de contenido: texto/flujo de eventos.
Punto final
POST /api/v2/translate/stream
Lo mejor para
Interfaces progresivas y contenido más largo.
{
"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}}La transmisión emite un metaevento, uno o más eventos delta y un evento final terminado.
El metaevento contiene el identificador de solicitud, la configuración regional y el modo.
Cada delta contiene una parte del resultado y done contiene la información de uso.
Una vez hecho esto, la conexión se cierra.
Trabajo sincronizado con las encuestas
Envíe un encabezado Idempotency-Key único al crear un trabajo.
Crear un punto final
POST /api/v2/jobs
Punto final de estado
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."
}
}Los trabajos permanecen disponibles durante siete días.
Encuesta en un intervalo razonable hasta que el estado sea completo o fallido.
Trabajo sincronizado con webhook
Primero cree y verifique un punto final de webhook en la aplicación Simple8. Luego haga referencia a su ID de punto final en el trabajo.
Crear un punto 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 envía un encabezado Simple8-Signature con una marca de tiempo y una firma HMAC SHA-256.
Verifique la firma con el cuerpo de la solicitud sin formato y el secreto de firma se muestra una vez cuando se crea el punto final.
Devuelve cualquier estado 2xx después de aceptar el evento.
Las entregas fallidas se reintentan hasta 50 veces durante siete días y los intentos recientes son visibles en la aplicación.
Los receptores deben tolerar la entrega duplicada porque los reintentos pueden entregar el mismo evento más de una vez.
Procesamiento por lotes
Envíe entre 1 y 50 elementos con un máximo combinado de 500.000 caracteres.
Crear un punto final
POST /api/v2/batches
Punto final de estado
GET /api/v2/batches/{id}
Cada elemento utiliza los mismos campos de texto, configuración regional y modo que una solicitud sincrónica.
Elija un sondeo o un punto final de webhook verificado para la entrega y envíe un encabezado Idempotency-Key único.