Introduzione
Fornisce API RESTful per la traduzione di documenti, supportando la gestione automatizzata delle attività di traduzione, la coerenza terminologica basata su glossari e query per formati supportati, lingue e modelli, rendendo semplice la creazione di flussi di lavoro di traduzione integrati e la gestione degli account utente.
Per iniziare
Per iniziare, devi presentare domanda per diventare sviluppatore.Candidati come sviluppatore
Una volta approvato, è possibile creare multiple chiavi API e includere la chiave API appropriata in ciascuna richiesta API come necessario.
Accesso rapido
Base URL
https://dltranslator.com/api
Metodo di autenticazione
Authorization: [yourSecretKey]
Richiesta JSON
Eccetto l'interfaccia di caricamento file, le interfacce utilizzano per impostazione predefinita richieste POST JSON, con Content-Type application/json.
Caricamento file
La creazione di un task di traduzione documenti utilizza multipart/form-data, il campo file passa il file da tradurre.
Risposta di errore generale
Quando la richiesta fallisce l'interfaccia restituisce JSON, il campo error contiene un messaggio di errore fisso in inglese. Si consiglia di gestire gli errori dando priorità al codice di stato HTTP, il campo error va utilizzato per la visualizzazione o la registrazione nei log.
{
"error": "Invalid API key."
}Regole dei codici di stato di errore
Tutte le risposte di errore API v1 mantengono la stessa struttura, gestire secondo le seguenti regole dei codici di stato HTTP.
- 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.".
Processo di integrazione consigliato
1. Crea attività
Carica il file e crea un'attività di traduzione, restituisce taskId.
2. Verifica progresso
Eseguire il polling dello stato dell'attività finché non risulta Completed, Terminated o Cancelled.
3. Ottieni risultato
Scarica il file tradotto o leggi il JSON dell'originale e della traduzione.
4. Gestisci attività
Pagamento a consumo per traduzione completa del testo, riavvio task, revisione testo o eliminazione task.