Çeviri Görevi API
Çeviri görevini sorgula
Bir çeviri görevinin durumunu ve ayrıntılarını sorgula.
- Tam adres
- https://dltranslator.com/api/v1/translation/query
- Doğrulama
- API Key'in Authorization istek başlığında iletilmesi gerekir
- Content-Type
- application/json
- Geçersiz format
- { "error": "Invalid API key." }
Dikkat Edilecek Hususlar
Görev durumu Waiting veya Processing iken bu arayüz yoklanması önerilir, durum Completed, Terminated veya Cancelled olduktan sonra yoklama durdurulur.
İndirme bağlantısı geçici erişim adresidir, lütfen uygulamanızda gerektiğinde dosyayı kaydedin veya yeniden sorgulayarak alın.
Örnek
1curl -X POST 'https://dltranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'İstek Parametreleri
| Parametreler | Tür | Varsayılan | Açıklama | Örnek |
|---|---|---|---|---|
| *taskId | String | - | Çeviri görevi kimliği | - |
Yanıt
| Parametreler | Tür | Varsayılan | Açıklama | Örnek |
|---|---|---|---|---|
| taskId | String | - | Görev Kimliği | - |
| model | String | - | Çeviri sırasında kullanılan model | - |
| fromLang | String | - | Kaynak Dil | - |
| toLang | String | - | Hedef dil | - |
| status | String | - | Durum: 'Başlatma' | 'Bekliyor' | 'İşleniyor' | 'Tamamlandı' | 'Sonlandırıldı' | 'İptal Edildi' | - |
| progress | Number | - | İlerleme, 0~100 | - |
| errorMsg | String | - | Hata bilgisi | - |
| fileTitle | String | - | Orijinal dosya adı | - |
| fileUrl | String | - | Orijinal dosya indirme adresi | - |
| translatedFileUrl | String | - | Çevirinin indirme adresi | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Düzenlenebilir çeviri dosyası indirme adresi. Yalnızca karşılık gelen dosya türü düzenlenebilir sonuç oluşturduğunda döndürülür. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Belge istatistik kelime sayısı. Farklı dosya türleri için boş olabilir. | - |
| price | Integer | - | Tüm çeviri için gereken Credits sayısı | - |
| usedCredits | Integer | - | Çeviri görevinin kullandığı Credits sayısı | - |
| glossary | String[] | - | Çeviri görevinde kullanılan terimler sözlüğü adı | - |
| shouldTranslateImage | Boolean | - | Belgedeki görseller çevrilsin mi | - |
| forceOCR | Boolean | - | Belge içeriğini tanımak için OCR kullanımı zorunlu tutulsun mu | - |
| createdAt | DateTime | - | Çeviri görevinin oluşturulma zamanı | - |
| updatedAt | DateTime | - | Çeviri görevinin güncelleme zamanı | - |
Yaygın Hatalar
401 Missing API key.
The Authorization request header is required.
401 Invalid API key.
The API key does not exist, has been deleted, or is no longer valid.
400 Missing required parameter: taskId.
Provide the taskId returned by the create translation task API.
404 Task not found.
The task does not exist, has been deleted, does not belong to the current API account, or was not created through the API.