Bu kılavuzda, Merchant API'nin sürüm oluşturma, yayınlama ve farklı sürümlerinin yaşam döngüsünü nasıl ele aldığı açıklanmaktadır.
Sürüm oluşturma şeması
Merchant API, alt API düzeyinde bir sürüm oluşturma stratejisi kullanır. Bu, Merchant API'deki Ürünler gibi her API'nin kendi sürüm yaşam döngüsüne sahip olacağı anlamına gelir.
Sürüm oluşturma biçimi ve sunumu
Kararlı alt API sürümleri: Bir alt API kararlı sürümdeyse tüm yöntemleri kararlı sürümde olur. Kararlı bir alt API sürümü vX (ör. v1, v2) olarak gösterilir. Bunlar, üretime hazır ana sürümlerdir.
Alfa alt API sürümleri: Bir alt API alfa sürümündeyse tüm yöntemleri alfa sürümündedir. Bir alfa alt API sürümü vXalpha (örneğin, v1alpha, v2alpha) olarak gösterilir. Bu sürümler, test ve hızlı yineleme için tasarlanmış deneysel, erken erişim özellikleri içerir. Alfa sürümleri kararlılık garantisi içermez, tanımlanmış bir kullanım ömrü yoktur ve 30 günlük bildirim süresiyle değiştirilebilir veya kullanımdan kaldırılabilir.
Sürüm değişiklikleri
Ana sürüm artışları (örneğin, v1'den v2'ye): Bunlar, geriye dönük uyumsuz ve zarar veren değişiklikleri gösterir. Bu değişiklikler için geliştirici müdahalesi gerekir. Yalnızca kararlı alt API'lerin uyumluluğu bozan değişiklikleri yeni bir sürüm numarasına sahip olur. Örneğin, v1'den v2'ye.
Küçük değişiklikler: Geriye dönük uyumlu eklemeler veya düzeltmeler, mevcut ana sürümde yapılan değişiklikler olarak sunulur. Bu tür değişiklikler, ilgili ana sürümün sürüm notlarında ayrıntılı olarak açıklanır. Bir alt API'ye eklenen ve mevcut işlevleri bozmayan özellikler, en son kararlı sürümün alfa kanalında veya doğrudan en son kararlı sürümde yayınlanır.
Desteği sonlandırma politikası
Eski Merchant alt API sürümlerini belirli aralıklarla kullanımdan kaldırırız. Kararlı ana sürümler (vX) için, resmi desteği sonlandırma duyurusundan itibaren 12 aylık bir desteği sonlandırma aralığı sunmayı taahhüt ediyoruz.
Örneğin, Ürünler alt API'sinin v1 sürümünün desteğini 15 Ocak 2026'da sonlandırırsak bu sürüm en erken 15 Ocak 2027'de kullanımdan kaldırılır. Bu tarihten sonra, alt API'nin önceki sürümü artık kullanılamayacak.
Alt API sürümü ve yaşam döngüsü durumu
Aşağıdaki tabloda, Merchant API'nin her bir alt API'sinin en son sürümleri listelenmektedir:
| Sub-API | Sürümler | Durum |
|---|---|---|
| Hesaplar | v1 v1alpha v1beta |
Etkin Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Dönüşümler | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Veri kaynakları | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırılacak |
| Envanterler | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Sorun çözümü | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Yerel feed'ler iş ortaklığı | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Bildirimler | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Sipariş takibi | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Ürünler | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Product Studio | v1alpha | Etkin |
| Tanıtımlar | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Kota | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Raporlar | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
| Yorumlar | v1alpha v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırılacak |
En iyi uygulamalar
- Yeni sürümler, önemli güncellemeler, iyileştirmeler ve alt API'lerin kullanıma sunulması ile desteğinin sonlandırılmasıyla ilgili duyurular için sürüm notlarını ve en son güncellemeleri düzenli olarak kontrol edin.
- Bir alt API'nin iki veya daha fazla kararlı sürümü varsa her zaman en son sürümü kullanmanızı öneririz.
- Uygulamanızı, ağ sorunları, sıklık sınırları ve yeni alt API sürümleriyle kullanıma sunulabilecek yeni hata kodları veya mesajlar da dahil olmak üzere çeşitli alt API hatalarını sorunsuz bir şekilde işleyecek şekilde tasarlayın.
- Alt API sürümünün desteği sonlandırılmak üzereyken yükseltme planlamaya başlamayın. Yeni sürümler kullanıma sunulur sunulmaz değerlendirmeye ve test etmeye başlayın.
- Özellik istekleri veya alt API yol haritasıyla ilgili endişeleriniz için soru ya da geri bildirimlerinizi ileterek bizimle iletişime geçin. Teknik destek için Merchant API Ekibi ile nasıl iletişime geçeceğiniz hakkında bilgi edinmek istiyorsanız Merchant API ile ilgili yardım alma başlıklı makaleyi inceleyin.