API Bütünleştirmesi Ayarlama
Lütfen API 2.0’ın artık kullanılacak tercih edilen sürüm olduğunu göz önünde bulundurun. Eski API, 2021’in sonuna kadar tamamen işlevsel kalacaktır.
Crowdin, GET veya POST yöntemlerini kullanarak HTTP üzerinden XML veya JSON ile RESTful API sağlar. Aşağıda listelenenler, Crowdin’de proje oluşturmanızı sağlayan tüm kullanılabilir API yöntemleridir, dosyaları ekleyin ve güncelleyin, çevirileri indirin veya yerelleştirmeyi geliştirme işleminizle bütünleştirin.
API Anahtarı Edinme ve Kullanma
Hesap API anahtarınızı bulmak için Crowdin hesabınıza oturum açmak zorundasınız. Hesap Ayarları sayfasını açın ve API sekmesine geçin.
Hemen hemen tüm API çağrılarının Proje Tanımlayıcısı (Kimlik) gerektirdiğini lütfen unutmayın. Proje tanımlayıcınızı Proje Ayarları > API ve Web Kancaları sekmesinde bulabilirsiniz.
İstekler Yapma
Yaptığınız her API isteği için kimlik doğrulaması yapılacak ana URI parametreleri olarak Hesap API anahtarını ve kullanıcı adını sunmanız gerekecek. Hesap API anahtarınızı gizli tutun! Normal hesap parolanız gibi korunmalıdır.
Burada API isteği URI’si şeklinin bir örneği ve ilkesi verilmiştir.
GET https://api.crowdin.com/api/project/{project-identifier}/download/all.zip?login={username}&account-key={account-key}
Normal API çağrı URL’si şuna benzer: https://api.crowdin.com/api/project/. İlk yer tutucu (parantezler içindeki anahtar kelime) proje tanımlayıcısını taşır. Hesap API anahtarı ve kullanıcı adı, URI parametreleri olarak belirtilir.
Oran Sınırları
Hesap başına eşzamanlı API çağrı sayısı 20 istektir. Eğer sınır aşılırsa, 429 hata kodu bir iletiyle birlikte gösterilecek: “Bu uç noktası için en fazla eşzamanlı istek sayısına ulaşıldı. Lütfen kısa bir süre sonra tekrar deneyin.”
Postman Kullanma
Postman, Crowdin API ile basit bir şekilde çalışmanızı sağlayan bir araçtır.
Mevcut tüm Crowdin API yöntemleri Postman’da zaten bir koleksiyon olarak kaydedilir. Bu koleksiyonu doğrudan Postman uygulamanıza içe aktarmak ve açmak için Postman’da Çalıştır düğmesine tıklayın.
Yöntemler
Dosya Ekleyin
Crowdin projesine yeni bir dosya ekleyin.
Dosya Güncelleyin
Kaynak dosyalarınızın (yerelleştirilmesi gerekenleri) en son sürümünü Crowdin projenize yükleyin.
Dosya Silin
Crowdin projesinden dosyayı silin. Tüm çeviriler, geri yükleme yeteneği olmadan kaybolacaktır.
Çeviri Yükleyin
Varolan çevirileri Crowdin projenize yükleyin. Yöntem, Varlıkların yerelleştirmesi için çalışmaz.
Çeviri Durumu
Her hedef dilin genel çeviri ve düzeltme okuması ilerlemelerini izleyin. Varsayılan yanıt biçimi XML’dir.
Dil Durumu
Belirtilen dil için ayrıntılı çeviri ilerlemesini alın.
Proje Ayrıntıları
Crowdin Projesi ayrıntılarını alın.
Bildirilen Sorunlar
Düzenleyicide bildirilen sorunların bir listesini alın.
Dosyayı Dışa Aktarın
Bu yöntem, Crowdin’den çevrilmiş tek dosyaları dışa aktarır. İlaveten, çevrimdışı yerelleştirme için XLIFF dosyalarını dışa aktarmak için uygulanabilir.
Çevirileri Dışa Aktarın
En son çevirilerle ZIP arşivi oluşturun.
Çeviri Dışa Aktarma Durumu
Çevirileri dışa aktarma durumunu alın.
Çevirileri İndirin
Çevirilerin olduğu bir ZIP dosyası indirin. İhtiyacınız olan çeviri dilini seçebilir veya hepsini aynı anda indirebilirsiniz.
Ön Çeviri
Crowdin proje dosyalarının ön çevirisini yapın.
Hesap Projeleri
Projeler listesini alın.
Proje Oluşturun
Crowdin projesi oluşturun.
Proje Düzenleyin
Crowdin projesini düzenleyin.
Proje Silin
Tüm çevirilerle Crowdin projesini silin.
Dizin Ekleyin
Crowdin projesine dizin ekleyin.
Dizin Değiştirin
Dizini yeniden adlandırın veya özniteliklerini değiştirin. Dizin yeniden adlandırılırken yol değiştirilemez (new_name parametresi yol içeremez, sadece ad içerebilir anlamına gelir).
Dizin Silin
Crowdin proje dizinini silin. İç içe olan tüm dosyalar ve dizinler de silinecektir.
Terimler Sözlüğü İndirin
Crowdin proje sözlüklerini TBX, CSV veya XLSX dosyası olarak indirin.
Terimler Sözlüğü Yükleyin
Crowdin Projesi için sözlüklerinizi TBX, CSV veya XLS/XLSX dosya biçimlerinde yükleyin.
ÇB İndirin
Crowdin proje Çeviri Belleğini TMX, CSV veya XLSX dosyası olarak indirin.
ÇB Yükleyin
Crowdin Projesi için Çeviri Belleğinizi TMX, CSV veya XLS/XLSX dosya biçimlerinde yükleyin.
Desteklenen Diller
Yerel ad ve standartlaştırılmış kodlarla eşlenen Crowdin kodlarıyla desteklenen diller listesini alın.
Sözde Dışa Aktarma
Bütün proje için sözde çeviri dosyaları oluşturun.
Sözde İndirme
Sözde çevirilere sahip ZIP dosyasını indirin.
Maliyet Tahmin Raporunu Dışa Aktarın
Bütçenin nasıl planlanacağı konusunda fikir sahibi olmak için Maliyet Tahmini raporu oluşturun. Bu rapor, projede şu anki çevrilmemiş dizgilerin yaklaşık çeviri maliyetini hesaplamanızı sağlar.
Maliyet Tahmin Raporunu İndirin
Önceden oluşturulmuş Maliyet Tahmin raporunu indirin.
Çeviri Maliyetleri Raporunu Dışa Aktarın
Gerçek çeviri maliyetini hesaplamak ve çevirmenlerinize ve düzeltmenlerinize ne kadar ödeme yapılması gerektiğini bilmek için Çeviri Maliyetleri raporu oluşturun.
Çeviri Maliyetleri Raporunu İndirin
Önceden oluşturulmuş Çeviri Maliyetleri raporunu indirin.
En İyi Üyeler Raporunu Dışa Aktarın
Belirtilen tarih aralığında projenizin çevirisine kimin en çok katkıda bulunduğunu öğrenmek için En İyi Üyeler raporu oluşturun.
En İyi Üyeler Raporunu İndirin
Önceden oluşturulmuş En İyi Üyeler raporunu indirin.
Crowdin API Java SDK
Crowdin API Java SDK, Java projenizdeki dosya ekleme ve güncelleme, çeviri indirme veya yerelleştirmeyi geliştirme sürecinize bütünleştirme gibi tüm Crowdin API yöntemleriyle çalışmanızı kolaylaştırmaya yardımcı olur.