API

Traduce JSON y archivos, consulta su progreso y descarga las traducciones completadas desde tu servidor.

Usa la API de Lingo.dev para traducir el contenido de tu aplicación. Un trabajo de localización combina un motor, un idioma de origen, idiomas de destino y uno o más documentos. Cada documento permite seguir el estado de una traducción de destino por cada idioma solicitado. La mayoría de los formatos generan archivos de destino independientes; los catálogos de cadenas de Apple reúnen varios idiomas en un solo archivo.

La URL base de la API es https://api.lingo.dev/v2. Mantén las credenciales de la API en tu servidor. Empieza con tu primera solicitud de traducción para traducir dos mensajes y guardar el resultado.

Elige el tipo de entrada #

Tu contenidoEmpieza aquí
Un objeto JSON que tu aplicación ya tieneTraducir JSON. Envía el objeto directamente en la solicitud de creación.
Archivos JSON, Markdown, HTML o recursos para aplicaciones móvilesTraducir documentos. Sube los bytes originales y descarga los archivos en el mismo formato.
Varios documentos o idiomas de destinoCrear un trabajo de traducción. Un mismo trabajo puede contener tanto JSON incluido directamente como archivos subidos.

Las tres opciones siguen el mismo ciclo de vida:

  1. Crea un trabajo y guarda su ID junto con la revisión del contenido de origen.
  2. Sube cada artefacto indicado en el array uploads de la respuesta. El contenido de origen en JSON incluido directamente se almacena al crear el trabajo.
  3. Inicia el trabajo.
  4. Consulta su progreso hasta que se completen las traducciones de destino necesarias de los documentos.
  5. Descarga cada traducción de destino completada desde su status.downloadUrl.

Al crear el trabajo, se guarda lo que hay que hacer; al iniciarlo, se admite el trabajo y comienza el procesamiento. Una respuesta de creación correcta no equivale a un resultado traducido.

Estima el trabajo antes de crearlo si necesitas comprobar qué se puede reutilizar y cuál será el coste aproximado.

Configura la traducción #

Selecciona explícitamente un motor con engineId. El motor proporciona modelos, glosarios, reglas y voz de marca, junto con el proceso de traducción. La clave de API debe tener acceso a ese motor para traducir.

Para JSON, añade contexto específico del documento, indicaciones y rutas protegidas mediante format.options. Para una revisión posterior, proporciona el contenido de origen anterior y sus traducciones para reutilizar el contenido que no haya cambiado.

La revisión humana permite que las personas autorizadas para revisar aprueben o editen las traducciones que cumplan los requisitos antes de que continúe el proceso. La guía del flujo de trabajo de revisión explica cómo conectar el envío, la revisión y la entrega.

Conserva el estado de la aplicación junto con el trabajo #

Guarda de forma persistente el ID del trabajo, la revisión del contenido de origen, las claves de los documentos y los idiomas solicitados antes de continuar. Usa la cabecera Idempotency-Key al crear un trabajo para poder repetir la solicitud si la respuesta no es concluyente, sin crear otro trabajo. Recupera el trabajo existente antes de enviar uno que lo sustituya.

Descarga las traducciones de destino completadas aunque falle otra. Publica un resultado solo si sigue correspondiendo a la revisión del contenido de origen que espera tu aplicación. Crear un flujo de trabajo de traducción explica cómo coordinar estos pasos.

Consulta la autenticación, los errores y el catálogo de errores para obtener información sobre el acceso y la recuperación.

Prepara y mejora un motor #

El aprovisionamiento completa los glosarios, las reglas y la voz de marca a partir del contenido de un sitio web o de texto. Las sugerencias del motor convierten los comentarios en propuestas que puedes revisar y aplicar. Revisa las directrices generadas antes de basarte en ellas para traducir.