Introduktion
Tillhandahåller RESTful API:er för dokumentöversättning, med stöd för automatiserad hantering av översättningsuppgifter, ordlistebaserad terminologikonsistens och förfrågningar om stödda format, språk och modeller, vilket gör det enkelt att bygga sömlösa översättningsarbetsflöden och hantera användarkonton.
Komma igång
För att komma igång behöver du ansöka om att bli utvecklare.Ansök som utvecklare
När detta har godkänts kan du skapa flera API-nycklar och inkludera lämplig API-nyckel i varje API-förfrågan enligt behov.
Snabb integrering
Base URL
https://dltranslator.com/api
Autentiseringsmetod
Authorization: [yourSecretKey]
JSON-begäran
Förutom filuppladdningsgränssnittet använder API:et som standard POST JSON-förfrågningar, Content-Type är application/json.
Filuppladdning
Att skapa en dokumentöversättningsuppgift använder multipart/form-data, fältet file överför filen som ska översättas.
Allmänt felsvar
Vid misslyckad förfrågan returnerar gränssnittet JSON, där error-fältet innehåller ett fast engelskt felmeddelande. Det rekommenderas att prioritera att hantera fel enligt HTTP-statuskod, medan error-fältet används för visning eller loggning.
{
"error": "Invalid API key."
}Regler för felstatuskoder
Alla v1 API-felsvar behåller samma struktur, hantera enligt HTTP-statuskodreglerna nedan.
- 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.".
Rekommenderad integreringsprocess
1. Skapa uppgift
Ladda upp fil och skapa översättningsuppgift, returnerar taskId.
2. Fråga om förlopp
Poller uppgiftsstatus tills Completed, Terminated eller Cancelled.
3. Hämta resultat
Ladda ner översatt fil, eller läs källtext och översättnings-JSON.
4. Hantera uppgifter
Betala per användning för fulltext översättning, omstart av uppgifter, revidering av text eller radering av uppgifter.