Oversættelsesopgave API
Forespørg oversættelsesopgaver
Forespørg status og detaljer for en oversættelsesopgave.
- Fuld adresse
- https://otranslator.com/api/v1/translation/query
- Autentificering
- API Key skal angives i Authorization-anmodningsheaderen
- Content-Type
- application/json
- Forkert format
- { "error": "Invalid API key." }
Forholdsregler
Det anbefales at polle denne grænseflade, når opgavestatus er Waiting eller Processing, og stoppe polling, når status bliver Completed, Terminated eller Cancelled.
Download-linket er en midlertidig adgangsadresse, gem venligst filen efter behov eller forespørg igen for at hente den.
Eksempel
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}'Forespørgselsparametre
| Parametre | Type | Standard | Beskrivelse | Eksempel |
|---|---|---|---|---|
| *taskId | String | - | Oversættelsesopgave-ID | - |
Svar
| Parametre | Type | Standard | Beskrivelse | Eksempel |
|---|---|---|---|---|
| taskId | String | - | Opgave-ID | - |
| model | String | - | Model anvendt til oversættelse | - |
| fromLang | String | - | Originalsprog | - |
| toLang | String | - | Målsprog | - |
| status | String | - | Status: 'Init' | 'Venter' | 'Behandler' | 'Fuldført' | 'Termineret' | 'Annulleret' | - |
| progress | Number | - | Fremskridt, 0~100 | - |
| errorMsg | String | - | Fejlmeddelelse | - |
| fileTitle | String | - | Originalfilnavn | - |
| fileUrl | String | - | Originalfilens downloadadresse | - |
| translatedFileUrl | String | - | Downloadadresse for oversættelsen | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Downloadadresse for redigerbar oversættelsesfil. Returneres kun når redigerbart resultat genereres for den tilsvarende filtype. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Dokumentstatistik ordtæller. Kan være tomt for forskellige filtyper. | - |
| price | Integer | - | Det samlede antal Credits der kræves til oversættelsen | - |
| usedCredits | Integer | - | Antal Credits brugt af oversættelsesopgaven | - |
| glossary | String[] | - | Terminologilistenavn anvendt til oversættelsesopgaven | - |
| shouldTranslateImage | Boolean | - | Om billeder i dokumentet skal oversættes | - |
| forceOCR | Boolean | - | Skal OCR tvinges til genkendelse af dokumentindhold | - |
| createdAt | DateTime | - | Oprettelsestidspunkt for oversættelsesopgaven | - |
| updatedAt | DateTime | - | Opdateringstidspunkt for oversættelsesopgaven | - |
Almindelige fejl
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.