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 que administra 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 progreso de un resultado de destino por cada idioma solicitado. La mayoría de los formatos generan archivos de destino separados; los catálogos de cadenas de Apple combinan los 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. Comienza con tu primera solicitud de traducción para traducir dos mensajes y guardar el resultado.
Elige el tipo de entrada #
| Tu contenido | Comienza aquí |
|---|---|
| Un objeto JSON que tu aplicación ya tiene | Traducir JSON. Envía el objeto directamente en la solicitud de creación. |
| Archivos como JSON, Markdown, HTML o recursos para dispositivos móviles | Traducir documentos. Carga los bytes originales y descarga los archivos en el mismo formato. |
| Varios documentos o idiomas de destino | Crear un trabajo de traducción. Un mismo trabajo puede contener tanto JSON integrado como archivos cargados. |
Las tres opciones siguen el mismo ciclo de vida:
- Crea un trabajo y guarda su ID junto con la revisión del contenido de origen.
- Carga cada artefacto indicado en el arreglo
uploadsde la respuesta. El contenido de origen en JSON integrado se almacena al crear el trabajo. - Inicia el trabajo.
- Consulta su progreso hasta que se completen los resultados de destino requeridos para los documentos.
- Descarga cada resultado de destino completado desde su
status.downloadUrl.
Al crear el trabajo, se guarda lo que se debe realizar; al iniciarlo, se acepta el trabajo y comienza su procesamiento. Una respuesta de creación exitosa no equivale a un resultado traducido.
Estima el trabajo antes de crearlo si necesitas consultar cuánto contenido se puede reutilizar y cuál será el costo 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, agrega contexto, indicaciones y rutas protegidas específicos del documento mediante format.options. Para una revisión posterior, proporciona el contenido de origen y las traducciones anteriores para reutilizar el contenido sin cambios.
La revisión humana permite que las personas autorizadas 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 el encabezado Idempotency-Key al crear un trabajo para poder reintentar la solicitud si la respuesta es incierta, sin crear otro trabajo. Recupera el trabajo existente antes de enviar uno que lo reemplace.
Descarga los resultados de destino completados incluso si otro falla. Publica un resultado solo si todavía corresponde a la revisión del contenido de origen que tu aplicación espera. Crear un flujo de trabajo de traducción explica cómo coordinar estos pasos.
Consulta autenticación, 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 pautas generadas antes de usarlas para traducir.