Consultar un trabajo de traducción

Revisa los destinos de los documentos, espera a que termine el trabajo y descarga los resultados disponibles.

Consulta un trabajo con el id devuelto al crearlo:

http
GET /v2/localization/jobs/:id
X-API-Key: YOUR_API_KEY

La respuesta describe todos los documentos y sus idiomas de destino. Puede incluir destinos completados mientras otros siguen en curso o han fallado.

Campos del trabajo #

CampoSignificado
id, organizationId, engineIdIdentidad del trabajo, organización propietaria y motor.
sourceLocaleIdioma de origen.
triggerOrigen, como api, cli, ci o una integración.
statusEstado etiquetado del trabajo, descrito a continuación.
createdAt, updatedAtMarcas de tiempo expresadas como cadenas en formato ISO.
createdByInformación de quien ha creado el trabajo, o null si no está disponible. Una clave personal se atribuye a su usuario.
documentsDocumentos, sus formatos y direcciones de origen, y el progreso de los destinos.
uploadsDirecciones de los artefactos que faltan y URL de subida mientras el trabajo está pendiente; el campo queda vacío una vez iniciado el trabajo.

Estados del trabajo #

status._tagQué hacer
PendingSube los artefactos que faltan y llama a /start.
RunningVuelve a consultar más tarde; revisa las etapas de los destinos para comprobar si el trabajo sigue en curso o está a la espera de revisión.
CompletedDescarga y revisa los resultados. Comprueba las advertencias de las etapas como parte del proceso de aceptación.
FailedConsulta status.message y los fallos de los destinos. Los destinos completados siguen disponibles.
CancelledEl trabajo se ha detenido. Revisa los destinos para comprobar si hay resultados ya completados.

Completed, Failed y Cancelled son estados finales del trabajo. Un fallo parcial es un trabajo fallido que combina destinos completados y fallidos.

Campos de documentos y destinos #

Cada documento contiene id, key, format, source, previousSource y targets. source es una dirección de artefacto incluso cuando la solicitud ha proporcionado JSON en línea. previousSource tiene el valor null cuando está ausente.

Cada destino contiene:

CampoSignificado
localeIdioma de destino.
previousTranslationDirección del artefacto de destino anterior, o null.
statusPending, Completed o Failed en su campo _tag.
stagesProgreso de las etapas, con el estado y el número de unidades.

El estado de un destino completado contiene artifact y downloadUrl; el de un destino fallido contiene message. Este fragmento de la respuesta muestra el estado de un destino completado:

json
{
  "_tag": "Completed",
  "artifact": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "downloadUrl": "/v2/localization/jobs/lfr_example/artifacts/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

Usa la dirección y la URL exactas que devuelve la respuesta. La URL es relativa a https://api.lingo.dev y requiere autenticación; no es un enlace público de descarga firmado. La descarga devuelve los bytes del archivo en el formato del documento.

Varios destinos pueden compartir un artefacto. Un catálogo de cadenas de Apple reúne los idiomas solicitados en un único archivo .xcstrings; guarda ese resultado combinado una sola vez y revisa sus entradas de idioma en lugar de tratar cada descarga como un catálogo independiente de un solo idioma.

Consultar periódicamente y recopilar #

Consulta el trabajo a intervalos definidos, por ejemplo, cada dos segundos, y establece un plazo máximo en la aplicación. Si una consulta falla de forma temporal, conserva el ID y vuelve a intentarlo con esperas progresivas. Dejar de esperar no cancela el procesamiento en el servidor. La revisión humana puede tardar mucho más que el breve tiempo de espera de una solicitud de la aplicación.

Descarga un destino en cuanto su estado sea Completed. Si tu aplicación necesita publicar todos los idiomas a la vez, espera a que se completen todos los destinos necesarios y aplica esa regla de publicación en tu propio almacenamiento. Que un archivo esté completado no demuestra que todos los idiomas se hayan procesado correctamente.

Para obtener un programa completo de consulta periódica y descarga, usa la guía de inicio rápido. Para gestionar las revisiones del contenido de origen y decidir cuándo reintentar, consulta cómo crear un flujo de trabajo de traducción.