Enviar una solicitud de traducción

Punto final para enviar una solicitud de traducción

Este punto final permite enviar una solicitud de traducción al sistema Ovesio. Puedes enviar múltiples textos en una sola solicitud, cada uno con sus propias claves y contextos, y la traducción puede realizarse simultáneamente en varios idiomas.

URL del punto final

 https://api.ovesio.com/v1/translate/request

Método

 POST

Formato de datos

 application/json

Ejemplo de solicitud JSON

 {
  "from": "en",
  "to": ["fr", "de"],
  "conditions": {
    "de": "fr"
  },
  "use_existing_translation": true,
  "delta_mode": false,
  "workflow": 1,
  "callback_url": "https://example.com/api/callback",
  "data": [
    {
      "ref": "product-123",
      "content": [
        {
          "key": "title",
          "value": "Gaming Laptop ASUS ROG"
        },
        {
          "key": "description",
          "value": "High-performance laptop for gaming",
          "context": "Specificații produs"
        }
      ]
    }
  ]
}

Parámetros de la aplicación

Parámetro	Tipo	Requerido	Descripción
from	cadena	sí	Idioma de origen. Si no se conoce, se puede omitir ( `AUTO`).
delta_mode	Booleano	no	Activar callback solo si la traducción es diferente de la anterior.
Workflow	entero	no	El ID del flujo de trabajo deseado.
use_existing_translation	Booleano	no	Si `false`, obliga a retraducir incluso si el texto ya existe en el sistema.
to	Array	sí	Idiomas de destino (por ejemplo, `["fr", "de"]`).
Conditions	Objeto	no	Permite definir idiomas intermedios en traducciones en cadena (por ejemplo, `{"de": "fr"}`).
callback_url	cadena	no	La URL a la que se enviarán los resultados de la traducción vía POST.
data	Array	sí	Textos a traducir.

Estructura del campo `data`

Requerido	Tipo		Descripción del campo
ref	cadena	no	Identificador único (por ejemplo, ID de producto, ítem, etc.).
content	Array	sí	Lista de textos, cada uno con su propio `value` y opcionales `key` y `context`.

Estructura del campo `content`

Requerido	Tipo		Descripción del campo
key	cadena	no	Etiqueta de texto (por ejemplo, `title`, `description` etc.).
Value	cadena	sí	El texto real a traducir.
context	cadena	no	Contexto semántico para la traducción (por ejemplo, "categoría de producto").

Posibles respuestas

Respuesta exitosa (HTTP 200)

 {
  "success": true,
  "data": [
    {
      "id": 320126,
      "ref": "product-123"
    }
  ]
}

Confirma que la aplicación ha sido aceptada y que el proceso de traducción ha sido iniciado. Puedes usar id para verificar el estado más tarde.

Respuesta de error (HTTP 400 u otro código ≠ 200)

 {
  "success": false,
  "errors": {
    "invalid_data": "Invalid format detected"
  }
}

Esta estructura indica que la solicitud fue inválida, y el campo errors contendrá detalles específicos sobre el problema encontrado.

Ejemplos de integración

Puedes consultar ejemplos de integración disponibles en la página oficial de GitHub de Ovesio.

¿Tiene alguna pregunta? Contáctanos