Übersetzungsaufträge auflisten
Aufträge nach Engine, Status, Auslöser oder Dienstschlüssel finden und per Cursor durch die Ergebnisse navigieren.
Listen Sie die Aufträge auf, die für den Aufrufer innerhalb einer Organisation sichtbar sind:
GET /v2/organizations/:orgId/localization/jobs?limit=50
X-API-Key: YOUR_API_KEYDie Antwort enthält data, ein Array mit Auftragsübersichten, sowie meta.nextCursor. Folgen Sie nextCursor, bis der Wert null ist. Eine leere Seite allein reicht nicht aus: Entscheidend ist der Wert des Cursors.
Filter #
| Parameter | Bedeutung |
|---|---|
engineIds | Zu berücksichtigende Engine-IDs. |
statuses | Pending, Running, Completed, Failed oder Cancelled. |
triggers | api, cli, ci, github, payload oder zendesk. |
apiKeyIds | Dienstschlüssel-IDs. Aufträge mit persönlichen Schlüsseln werden dem jeweiligen Nutzer zugeordnet. |
limit | Ganzzahl von 1 bis 100; Standardwert: 50. |
cursor | Opaker Cursor aus der vorherigen Antwort. |
Geben Sie einen Array-Parameter für mehrere Werte wiederholt an, zum Beispiel statuses=Running&statuses=Failed. Behalten Sie die Filter bei, während Sie einem Cursor folgen. Die neuesten Aufträge werden zuerst zurückgegeben. Bei gleichem Erstellungszeitpunkt bestimmt die Auftrags-ID die Reihenfolge.
Felder der Auftragsübersicht #
Jede Auftragsübersicht enthält id, organizationId, engineId, sourceLocale, trigger, status, createdAt, updatedAt und createdBy. Der Status ist ein Objekt mit Typkennzeichnung, zum Beispiel { "_tag": "Running" }. Ein Fehlerstatus enthält zusätzlich message.
Auftragsübersichten enthalten weder Dokumente noch Ausgabedateien. Rufen Sie einen Auftrag ab, indem Sie id verwenden, um die zugehörigen Dokumentschlüssel, Zielsprachen, den Fortschritt der einzelnen Phasen und die Download-URLs zu erhalten.
Speichern Sie nach Möglichkeit die ID aus der Erstellungsantwort in Ihrer eigenen Anwendung. Die Auftragsliste hilft bei Untersuchungen und der Wiederherstellung. Die Quellrevision, aus der ein Auftrag entstanden ist, sollte jedoch in den Aufzeichnungen Ihrer Anwendung festgehalten werden.