Geliştirici Olarak Kayıt Olun ve API Anahtarı Alın
Belge çevirisi için RESTful API'ler sağlar; otomatik çeviri görevi yönetimi, sözlük tabanlı terminoloji tutarlılığı ve desteklenen formatlar, diller ve modeller için sorgular destekler, böylece sorunsuz çeviri iş akışları oluşturmayı ve kullanıcı hesaplarını yönetmeyi kolaylaştırır.
Başlangıç
Başlamak için geliştirici olmak üzere başvuru yapmanız gerekmektedir.Geliştirici olarak başvur
Onaylandıktan sonra, birden fazla API anahtarı oluşturabilir ve gerektiğinde her API isteğine uygun API anahtarını dahil edebilirsiniz.
Hızlı Entegrasyon
Temel URL
https://dltranslator.com/api
Doğrulama Yöntemi
Authorization: [yourSecretKey]
JSON isteği
Dosya yükleme arayüzü dışında, API varsayılan olarak POST JSON isteği kullanır, Content-Type application/json'dır.
Dosya Yükleme
Belge çeviri görevi oluşturmak için multipart/form-data kullanılır, file alanına çevrilecek dosya iletilir.
Genel hata yanıtı
İstek başarısız olduğunda arayüz JSON döner, error alanı sabit İngilizce hata bilgisini içerir. Hataları HTTP status code'a göre öncelikle işlemeniz önerilir, error alanı gösterim veya günlük kaydı için kullanılır.
{
"error": "Invalid API key."
}Hata Durum Kodu Kuralları
Tüm v1 API hata yanıtları aynı yapıyı korur, lütfen aşağıdaki HTTP durum kodu kurallarına göre işlem yapın.
- 400 Bad Request
- Gerekli parametreler eksik, parametre formatları veya enum değerleri geçersiz, dosya yüklemesi eksik, yükleme kaydedilemedi veya görev işlenemedi.
- 401 Unauthorized
- API anahtarı eksik veya geçersiz.
- 402 Payment Required
- Önizleme, tam çeviri veya metin çevirisi için yetersiz kredi bakiyesi.
- 404 Not Found
- Görev veya sözlük mevcut değil, silinmiş, mevcut API hesabına ait değil ya da API aracılığıyla oluşturulmamış.
- 409 Conflict
- Mevcut görev durumu istenen işleme izin vermiyor.
- 500 Internal Server Error
- Beklenmeyen sunucu istisnası. Yanıt hatası "Dahili sunucu hatası." olarak düzeltildi.
Önerilen entegrasyon süreci
1. Görev oluşturma
Dosya yükleyin ve çeviri görevi oluşturun, taskId döndürülür.
2. İlerleme sorgulama
Görev durumu Completed, Terminated veya Cancelled olana kadar sorgulayın.
3. Sonuç alma
Çevrilen dosyayı indirin veya kaynak ve çeviri JSON'unu okuyun.
4. Görev yönetimi
Tam metin çevirisi, görevi yeniden başlatma, metni revize etme veya görevi silme için talep üzerine ödeme yapın.