Giriş
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
Base 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
- 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.".
Ö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.