Registrati come Sviluppatore e Ottieni una Chiave API
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
URL Base
https://otranslator.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
- Parametri obbligatori mancanti, formati di parametri o valori enum non validi, caricamento file mancante, errore di salvataggio del caricamento o errore di elaborazione dell'attività.
- 401 Unauthorized
- Chiave API mancante o non valida.
- 402 Payment Required
- Crediti insufficienti per anteprima, traduzione completa o traduzione del testo.
- 404 Not Found
- Il task o il glossario non esiste, è stato eliminato, non appartiene all'account API corrente o non è stato creato tramite l'API.
- 409 Conflict
- Lo stato attuale dell'attività non consente l'operazione richiesta.
- 500 Internal Server Error
- Eccezione imprevista del server. L'errore di risposta è definito come "Errore interno del server.".
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.