Oversettelsesoppgave-API
Forespørsel om oversettelsesoppgaver
Spør om status og detaljer for en oversettelsesoppgave.
- Fullstendig adresse
- https://otranslator.com/api/v1/translation/query
- Autentisering
- API-nøkkelen må angis i Authorization-forespørselhodet
- Content-Type
- application/json
- Feil format
- { "error": "Invalid API key." }
Forsiktighetsregler
Det anbefales å polle dette grensesnittet når oppgavestatusen er Waiting eller Processing, og stoppe polling når statusen går over til Completed, Terminated eller Cancelled.
Nedlastingslenken er en midlertidig tilgangsadresse, vennligst lagre filen etter behov eller hent den på nytt.
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ørselsparametere
| Parametere | Type | Standard | Beskrivelse | Eksempel |
|---|---|---|---|---|
| *taskId | String | - | Oversettelsesjobb-ID | - |
Svar
| Parametere | Type | Standard | Beskrivelse | Eksempel |
|---|---|---|---|---|
| taskId | String | - | Oppgave-ID | - |
| model | String | - | Modellen som ble brukt ved oversettelse | - |
| fromLang | String | - | Kildespråk | - |
| toLang | String | - | Målspråk | - |
| status | String | - | Status: 'Init' | 'Venter' | 'Prosesserer' | 'Fullført' | 'Avsluttet' | 'Kansellert' | - |
| progress | Number | - | Fremdrift, 0~100 | - |
| errorMsg | String | - | Feilmelding | - |
| fileTitle | String | - | Originalfilnavn | - |
| fileUrl | String | - | Nedlastingsadresse for originalfil | - |
| translatedFileUrl | String | - | Nedlastingsadresse for oversettelsen | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Nedlastingsadresse for redigerbar oversettingsfil. Returneres kun når redigerbart resultat genereres for tilsvarende filtype. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Dokumentstatistikk ordantall. Kan være tom for ulike filtyper. | - |
| price | Integer | - | Totalt antall Credits som kreves for oversettelsen | - |
| usedCredits | Integer | - | Antall Credits brukt av oversettelsesoppgaven | - |
| glossary | String[] | - | Navn på ordliste som brukes for oversettelsesoppgaven | - |
| shouldTranslateImage | Boolean | - | Om bilder i dokumentet skal oversettes | - |
| forceOCR | Boolean | - | Tving bruk av OCR for å gjenkjenne dokumentinnhold | - |
| createdAt | DateTime | - | Opprettelsestidspunkt for oversettelsesoppgaven | - |
| updatedAt | DateTime | - | Oppdateringstidspunkt for oversettelsesoppgaven | - |
Vanlige feil
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.