Devolución de llamada - Envío automático de resultados

Para evitar verificaciones constantes por parte del cliente respecto al estado de las traducciones o la generación de contenido, la plataforma Ovesio ofrece un mecanismo de notificación devolución de llamada automático.

Este mecanismo implica el envío automático del resultado a una URL proporcionada por el cliente, tan pronto como la operación se haya completado con éxito.

Cómo funciona

• Si se establece una callback_url en la solicitud de API o en el flujo de trabajo, el sistema enviará automáticamente el resultado utilizando el método POST a esa dirección.
• La respuesta enviada es de tipo application/json y contiene la estructura de resultado específica para cada tipo de operación:
  • traducciones (una publicación por cada idioma)
  • generar descripciones
  • generar etiquetas meta SEO

Requisitos de la URL de devolución de llamada

• Debe devolver el código de estado HTTP 200
• Debe responder con el JSON:

   {
  "success": true
  }

• Cualquier otro tipo de respuesta o código de estado será considerado inválido.

Mecanismo de reintento

En caso de una respuesta inválida, el sistema intentará automáticamente 3 veces (primera vez + 2 reintentos).

Si no se recibe una respuesta válida después de 3 intentos, la operación se marcará como fallida al enviar. Posteriormente, el cliente tiene dos opciones:

• Puede reenviar manualmente el resultado directamente desde la aplicación Ovesio
• Puede obtener el resultado utilizando el punto final de API de estado dedicado u otros puntos finales destinados a recuperar el estado

Reglas específicas para traducciones

La devolución de llamada de traducción se envía únicamente bajo las siguientes condiciones:

1. Si la opción de devolución de llamada está habilitada en el flujo de trabajo y:
   • se define un callback_url por defecto
   • la opción "Ignorar Devolución de Llamada Duplicada" está deshabilitada

   Si la opción "Ignorar Devolución de Llamada Duplicada" está habilitada, una devolución de llamada se enviará únicamente para nuevas traducciones. Las solicitudes que apunten a textos previamente traducidos no activarán una nueva devolución de llamada.

2. Si se envía explícitamente un callback_url en la solicitud de API, incluso si el flujo de trabajo tiene una URL por defecto diferente.
   • Si desea habilitar el comportamiento de evitar devoluciones de llamada duplicadas, puede usar el parámetro:

    "delta_mode": true

   El valor por defecto es false.

⚠ En el caso de generación de contenido (descripciones, etiquetas meta), la opción "Ignorar Devolución de Llamada Duplicada" no se aplica, y la respuesta siempre se enviará si un callback_url está presente.

Formato de las respuestas enviadas a través de la devolución de llamada

1. Traducción de texto

 {
  "id": 346,
  "ref": "product/7492",
  "to": "en",
  "from": "ro",
  "content": [
    {
      "key": "description",
      "value": "<p>...</p>"
    }
  ]
}

2. Generar descripciones

 {
  "id": 3419,
  "ref": "product/72017",
  "to": "ro",
  "content": {
    "description": "<p>...</p>"
  }
}

3. Generar etiquetas meta SEO

 {
  "id": 3422,
  "ref": "product/71072",
  "to": "ro",
  "content": {
    "seo_h1": "...",
    "seo_h2": "...",
    "seo_h3": "...",
    "meta_title": "...",
    "meta_description": "...",
    "meta_keywords": "..."
  }
}