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, un arreglo de resúmenes de trabajos, y meta.nextCursor. Sigue nextCursor hasta que sea null; una página vacía por sí sola no reemplaza la verificación del 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 creados 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 arreglo para indicar varios valores, por ejemplo statuses=Running&statuses=Failed. Mantén los filtros sin cambios mientras sigues un cursor. Los trabajos se devuelven del más reciente al más antiguo; si coinciden las marcas de tiempo 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 documentos ni archivos de salida. Obtén un trabajo mediante id para consultar sus claves de documento, idiomas de destino, progreso por etapa y URL de descarga.
Siempre que sea posible, guarda en tu propia aplicación el ID que devuelve la respuesta de creación. Listar los trabajos es útil para tareas de investigación y recuperación, pero la revisión del contenido de origen que generó un trabajo debe quedar registrada en tu aplicación.