Daftar sebagai Developer dan Dapatkan API Key

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.

Dapatkan kunci API Anda

Akses Cepat

URL Dasar

https://otranslator.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: Parameter yang diperlukan tidak tersedia, format parameter atau nilai enum tidak valid, pengunggahan file tidak tersedia, kegagalan penyimpanan pengunggahan, atau kegagalan pemrosesan tugas.
401 Unauthorized: Kunci API tidak tersedia atau tidak valid.
402 Payment Required: Saldo kredit tidak mencukupi untuk pratinjau, terjemahan penuh, atau terjemahan teks.
404 Not Found: Tugas atau glosarium tidak ada, telah dihapus, tidak termasuk dalam akun API saat ini, atau tidak dibuat melalui API.
409 Conflict: Status tugas saat ini tidak mengizinkan operasi yang diminta.
500 Internal Server Error: Eksepsi server yang tidak terduga. Error respons ditetapkan sebagai "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.

Sumber Daya

Komunitas pengembang

Jika Anda memiliki pertanyaan, Anda dapat memperoleh bantuan di komunitas pengembang.