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ümlerde, test ve hızlı yineleme için tasarlanmış deneysel erken erişim özellikleri bulunur. Alfa sürümlerinde kararlılık garantisi verilmez, 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, söz konusu ana sürümün sürüm notlarında ayrıntılı olarak açıklanır. Bir alt API'ye yapılan, mevcut işlevleri bozmayan eklemeler, 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 kullanımdan kaldırma duyurusundan itibaren 12 aylık bir kullanımdan kaldırma aralığı sunmayı taahhüt ediyoruz.
Örneğin, Products 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 v1beta |
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 kullanımdan kaldı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 sorularınız ya da geri bildirimlerinizle bize ulaşın. 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.