Introduktion
Leverer RESTful API'er til dokumentoversættelse, der understøtter automatiseret håndtering af oversættelsesopgaver, ordlistebaseret terminologisk konsistens og forespørgsler om understøttede formater, sprog og modeller, hvilket gør det nemt at bygge sømløse oversættelsesworkflows og administrere brugerkonti.
Kom i gang
For at komme i gang skal du ansøge om at blive udvikler.Ansøg som udvikler
Når det er godkendt, kan du oprette flere API-nøgler og inkludere den relevante API-nøgle i hver API-anmodning efter behov.
Hurtig integration
Base URL
https://otranslator.com/api
Autentificeringsmetode
Authorization: [yourSecretKey]
JSON anmodning
Bortset fra filupload-interfacet bruger interfacerne som standard POST JSON-anmodninger, hvor Content-Type er application/json.
Filopload
Oprettelse af dokumentoversættelsesopgave bruger multipart/form-data, file-feltet overfører den fil, der skal oversættes.
Generel fejlsvar
Når anmodningen mislykkes, returnerer interfacet JSON, error-feltet indeholder en fast engelsk fejlmeddelelse. Det anbefales først at håndtere fejl baseret på HTTP-statuskode, error-feltet bruges til visning eller logregistrering.
{
"error": "Invalid API key."
}Regler for fejlstatuskoder
Alle v1 API fejlsvar opretholder samme struktur, behandl venligst efter nedenstående HTTP status code regler.
- 400 Bad Request
- Missing required parameters, invalid parameter formats or enum values, missing file upload, upload save failure, or task processing failure.
- 401 Unauthorized
- Missing API key or invalid API key.
- 402 Payment Required
- Insufficient credits balance for preview, full translation, or text translation.
- 404 Not Found
- The task or glossary does not exist, has been deleted, does not belong to the current API account, or was not created through the API.
- 409 Conflict
- The current task status does not allow the requested operation.
- 500 Internal Server Error
- Unexpected server exception. The response error is fixed as "Internal server error.".
Anbefalet integrationsproces
1. Opret opgave
Upload fil og opret oversættelsesopgave, returnerer taskId.
2. Forespørg fremskridt
Forespørg opgavestatus indtil Completed, Terminated eller Cancelled.
3. Hent resultat
Download oversat fil, eller læs original og oversættelse som JSON.
4. Administrer opgaver
Betal efter brug for fuld tekstoversættelse, genstart opgaver, revidér tekst eller slet opgaver.