Pengantar
Menyediakan API RESTful untuk terjemahan dokumen, mendukung manajemen tugas terjemahan otomatis, konsistensi terminologi berbasis glosarium, dan kueri untuk format, bahasa, dan model yang didukung, memudahkan pembangunan alur kerja terjemahan yang mulus dan pengelolaan akun pengguna.
Memulai
Untuk memulai, Anda perlu mengajukan permohonan menjadi pengembang.Mendaftar sebagai pengembang
Setelah disetujui, Anda dapat membuat beberapa API key dan menyertakan API key yang sesuai dalam setiap permintaan API sesuai kebutuhan.
Akses Cepat
Base URL
https://dltranslator.com/api
Metode Autentikasi
Authorization: [yourSecretKey]
Permintaan JSON
Selain interface unggah file, interface secara default menggunakan permintaan POST JSON, Content-Type adalah application/json.
Unggah File
Membuat tugas penerjemahan dokumen menggunakan multipart/form-data, field file mengirimkan file yang akan diterjemahkan.
Respons Kesalahan Umum
Ketika permintaan gagal, interface akan mengembalikan JSON, field error berisi pesan error bahasa Inggris yang tetap. Disarankan untuk memprioritaskan penanganan error berdasarkan HTTP status code, field error digunakan untuk tampilan atau pencatatan log.
{
"error": "Invalid API key."
}Aturan Kode Status Kesalahan
Semua respons kesalahan API v1 memiliki struktur yang sama, harap ditangani sesuai aturan kode status HTTP berikut.
- 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.".
Proses integrasi yang direkomendasikan
1. Membuat tugas
Unggah file dan buat tugas terjemahan, kembalikan taskId.
2. Memeriksa kemajuan
Polling status tugas, hingga Completed, Terminated, atau Cancelled.
3. Mendapatkan hasil
Unduh file terjemahan, atau baca JSON asli dan terjemahan.
4. Mengelola tugas
Bayar sesuai kebutuhan untuk terjemahan teks lengkap, mulai ulang tugas, revisi teks, atau hapus tugas.