Listar trabajos de traducción
Busca trabajos por motor, estado, desencadenante o clave de servicio y recorre los resultados con paginación por cursor.
Lista los trabajos de una organización visibles para quien realiza la llamada:
GET /v2/organizations/:orgId/localization/jobs?limit=50
X-API-Key: YOUR_API_KEYLa respuesta contiene data, una matriz de resúmenes de trabajos, y meta.nextCursor. Sigue nextCursor hasta que sea null; una página vacía no basta para dejar de comprobar el cursor.
Filtros #
| Parámetro | Significado |
|---|---|
engineIds | ID de los motores que se incluirán. |
statuses | Pending, Running, Completed, Failed o Cancelled. |
triggers | api, cli, ci, github, payload o zendesk. |
apiKeyIds | ID de las claves de servicio. Los trabajos realizados con claves personales se atribuyen al usuario. |
limit | Número entero de 1 a 100; el valor predeterminado es 50. |
cursor | Cursor opaco devuelto en la respuesta anterior. |
Repite un parámetro de tipo matriz para indicar varios valores, por ejemplo statuses=Running&statuses=Failed. Mantén los mismos filtros mientras recorres los resultados con un cursor. Los trabajos se devuelven del más reciente al más antiguo; si coinciden las fechas y horas de creación, el ID del trabajo determina el orden.
Campos del resumen #
Cada resumen contiene id, organizationId, engineId, sourceLocale, trigger, status, createdAt, updatedAt y createdBy. El estado es un objeto etiquetado, como { "_tag": "Running" }; un estado de error también incluye message.
Los resúmenes no incluyen los documentos ni los archivos de salida. Obtén un trabajo mediante id para consultar sus claves de documento, idiomas de destino, progreso de las etapas y URL de descarga.
Siempre que sea posible, guarda en tu propia aplicación el ID devuelto en la respuesta de creación. Listar los trabajos resulta útil para tareas de investigación y recuperación, pero la revisión de origen que generó un trabajo debe constar en los registros de tu aplicación.