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, 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 (örneğin, 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ü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ştiricinin işlem yapması 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.
Kullanımdan kaldırma politikası
Eski Merchant alt API sürümlerini düzenli olarak 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ü 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ıldı |
| Dönüşümler | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Veri kaynakları | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı |
| Envanterler | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Sorun çözümü | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Yerel feed'ler iş ortaklığı | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Bildirimler | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Sipariş takibi | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Ürünler | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Product Studio | v1alpha | Etkin |
| Tanıtımlar | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Kota | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Raporlar | v1 v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldırıldı. |
| Yorumlar | v1alpha v1beta |
Etkin 28 Şubat 2026'da kullanımdan kaldı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 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 kullanımdan kaldırılmasını beklemeyin. Yükseltme planınızı yapmaya başlayın. Yeni sürümleri kullanıma sunuldukları anda değerlendirmeye ve test etmeye başlayın.
- Özellik istekleri veya bir alt API yol haritasıyla ilgili endişeleriniz için sorularınız ya da geri bildirimlerinizle ilgili olarak bizimle iletişime geçin. Merchant API ekibiyle teknik destek için nasıl iletişime geçeceğiniz hakkında bilgi edinmek üzere Merchant API ile ilgili yardım alma başlıklı makaleyi inceleyin.