Bu rehberde, 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, her Merchant API'nin (ör. Merchant API'deki Ürünler) 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. 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ü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 bozucu değişiklikleri gösterir. Bu değişiklikler için geliştirici işlemi 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 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ğin sonlandırılması politikası
Eski Merchant alt API sürümlerini belirli aralıklarla kullanımdan kaldırırız. Resmi kullanımdan kaldırma duyurusundan itibaren kararlı ana sürümler (vX) için 12 aylık bir kullanımdan kaldırma süresi 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ü kullanılamayacaktır.
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 desteği sonlandırıldı |
| Veri kaynakları | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı |
| Envanterler | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
| Sorun çözümü | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
| Yerel feed iş ortaklığı | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
| Bildirimler | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
| Sipariş takibi | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
| Ürünler | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
| Product Studio | v1alpha | Etkin |
| Tanıtımlar | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
| Kota | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
| Raporlar | v1 v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
| Yorumlar | v1alpha v1beta |
Etkin 28 Şubat 2026'da desteği sonlandırıldı |
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 daha 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. Merchant API ekibiyle teknik destek için 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.