Übersetzungsaufgaben-API
Übersetzungsaufgaben abfragen
Status und Details einer Übersetzungsaufgabe abfragen.
- Vollständige Adresse
- https://otranslator.com/api/v1/translation/query
- Authentifizierung
- Der API Key muss im Authorization-Anfrage-Header übermittelt werden
- Content-Type
- application/json
- Falsches Format
- { "error": "Invalid API key." }
Hinweise
Es wird empfohlen, diese Schnittstelle abzufragen, wenn der Aufgabenstatus Waiting oder Processing ist, und die Abfrage zu stoppen, nachdem der Status in Completed, Terminated oder Cancelled übergegangen ist.
Der Download-Link ist eine temporäre Zugangsadresse, bitte speichern Sie die Datei bei Bedarf anwendungsseitig oder rufen Sie sie erneut ab.
Beispiel
1curl -X POST 'https://otranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'Anfrageparameter
| Parameter | Typ | Standard | Beschreibung | Beispiel |
|---|---|---|---|---|
| *taskId | String | - | Übersetzungsauftrags-ID | - |
Antwort
| Parameter | Typ | Standard | Beschreibung | Beispiel |
|---|---|---|---|---|
| taskId | String | - | Aufgaben-ID | - |
| model | String | - | Für die Übersetzung verwendetes Modell | - |
| fromLang | String | - | Ausgangssprache | - |
| toLang | String | - | Zielsprache | - |
| status | String | - | Status: 'Init' | 'Wartend' | 'In Bearbeitung' | 'Abgeschlossen' | 'Beendet' | 'Abgebrochen' | - |
| progress | Number | - | Fortschritt, 0~100 | - |
| errorMsg | String | - | Fehlermeldung | - |
| fileTitle | String | - | Originaldateiname | - |
| fileUrl | String | - | Download-Adresse der Originaldatei | - |
| translatedFileUrl | String | - | Download-Adresse der Übersetzung | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Download-Adresse der bearbeitbaren Übersetzungsdatei. Wird nur zurückgegeben, wenn für den entsprechenden Dateityp ein bearbeitbares Ergebnis generiert wird. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Wortzahl-Statistik des Dokuments. Kann bei verschiedenen Dateitypen leer sein. | - |
| price | Integer | - | Gesamtanzahl der für die Übersetzung erforderlichen Credits | - |
| usedCredits | Integer | - | Anzahl der von der Übersetzungsaufgabe verwendeten Credits | - |
| glossary | String[] | - | Name des für die Übersetzungsaufgabe verwendeten Glossars | - |
| shouldTranslateImage | Boolean | - | Ob Bilder im Dokument übersetzt werden sollen | - |
| forceOCR | Boolean | - | OCR zur Erkennung des Dokumentinhalts erzwingen | - |
| createdAt | DateTime | - | Erstellungszeit der Übersetzungsaufgabe | - |
| updatedAt | DateTime | - | Aktualisierungszeit der Übersetzungsaufgabe | - |
Häufige Fehler
401 Missing API key.
The Authorization request header is required.
401 Invalid API key.
The API key does not exist, has been deleted, or is no longer valid.
400 Missing required parameter: taskId.
Provide the taskId returned by the create translation task API.
404 Task not found.
The task does not exist, has been deleted, does not belong to the current API account, or was not created through the API.