Lister les tâches de traduction
Recherchez des tâches par moteur, statut, déclencheur ou clé de service, puis parcourez les résultats à l’aide de la pagination par curseur.
Listez les tâches d’une organisation visibles par l’appelant :
GET /v2/organizations/:orgId/localization/jobs?limit=50
X-API-Key: YOUR_API_KEYLa réponse contient data, un tableau de résumés de tâches, et meta.nextCursor. Suivez nextCursor jusqu’à ce qu’il soit null ; une page vide ne suffit pas à elle seule : vous devez vérifier le curseur.
Filtres #
| Paramètre | Signification |
|---|---|
engineIds | Identifiants des moteurs à inclure. |
statuses | Pending, Running, Completed, Failed ou Cancelled. |
triggers | api, cli, ci, github, payload ou zendesk. |
apiKeyIds | Identifiants des clés de service. Les tâches créées avec une clé personnelle sont attribuées à l’utilisateur. |
limit | Entier compris entre 1 et 100 ; valeur par défaut : 50. |
cursor | Curseur opaque renvoyé dans la réponse précédente. |
Répétez un paramètre de type tableau pour transmettre plusieurs valeurs, par exemple statuses=Running&statuses=Failed. Conservez les mêmes filtres lorsque vous suivez un curseur. Les tâches sont renvoyées de la plus récente à la plus ancienne ; si plusieurs tâches ont le même horodatage de création, leur identifiant détermine l’ordre.
Champs du résumé #
Chaque résumé contient id, organizationId, engineId, sourceLocale, trigger, status, createdAt, updatedAt et createdBy. Le statut est un objet doté d’un discriminant, tel que { "_tag": "Running" } ; un statut d’échec inclut également message.
Les résumés n’incluent ni les documents ni les fichiers de sortie. Récupérez une tâche à l’aide de id pour obtenir les clés de ses documents, ses langues cibles, l’avancement de ses étapes et ses URL de téléchargement.
Dans la mesure du possible, enregistrez dans votre application l’identifiant renvoyé dans la réponse de création. Lister les tâches est utile pour les investigations et la récupération, mais la révision source à l’origine d’une tâche doit figurer dans les données enregistrées par votre application.