Bu kılavuzda, Merchant API'nin sürümleri, sürümleri yayınlama ve farklı sürümlerinin yaşam döngüsünü nasıl yönettiği açıklanmaktadır.
Sürüm oluşturma şeması
Satıcı API'si, alt API düzeyinde bir sürüm stratejisi kullanır. Bu, Merchant API'deki bileşenlerin veya hizmetlerin kendi sürüm yaşam döngülerine 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 de kararlı sürümdedir. Mevcut alt API sürümü, vX olarak gösterilir (örneğin, v1, v2). Bunlar, üretime hazır büyük sürümlerdir.
Alfa alt API sürümleri: Bir alt API alfa sürümündeyse tüm yöntemleri de alfa sürümündedir. Alfa alt API sürümü, vXalpha olarak gösterilir (ör. v1alpha, v2alpha). Bunlar, test ve hızlı iterasyon için tasarlanmış erken erişim, deneysel sürümlerdir. Alfa sürümleri, kararlılık garantisi sunmaz ve kullanım ömrü garanti edilmez. Alfa sürümleri, 30 günlük bir bildirim süresiyle değiştirilebilir veya kullanımdan kaldırılabilir.
Sürüm değişiklikleri
Büyük sürüm artışları (ör. 1. sürümden 2. sürüme): Bunlar, geliştirici müdahalesi gerektiren geriye dönük uyumsuz ve önemli değişiklikleri gösterir. Yalnızca kararlı alt API'lerde yapılan ve çalışma şeklini değiştiren değişiklikler 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ümdeki değişiklikler olarak sunulur. Bu tür değişiklikler, ilgili büyük sürümün sürüm notlarında ayrıntılı olarak açıklanır. Bir alt API'ye yapılan ve çalışmayı kesintiye uğratmayan eklemeler, en son kararlı sürümün alfa kanalında veya doğrudan en son kararlı sürümde yayınlanır.
Günbatımları
Eski satıcı alt API sürümlerini düzenli olarak kullanımdan kaldırırız. Resmi kullanımdan kaldırma duyurusundan itibaren kararlı büyük sürümler (vX) için 12 aylık bir kullanımdan kaldırma aralığı sunuyoruz.
Örneğin, Products alt API'sinin 1. sürümünü 15 Ocak 2026'da kullanımdan kaldı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 alt API'sinin en son sürümleri listelenmiştir:
| Alt API | Alfa sürümleri | Beta sürümleri | Durum |
|---|---|---|---|
| Hesaplar | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Ürünler | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Ürün girişleri | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Yerel envanterler | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Bölgesel envanterler | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Veri kaynakları | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Promosyonlar | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Raporlar | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Dönüşüm sayısı | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Bildirimler | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Yorumlar | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Kargo ayarları | Kullanılamıyor | v1 beta | v1 beta sürümü etkin |
| Product Studio | v1 alpha | Kullanılamıyor | v1 alfa sürümü etkin |
En iyi uygulamalar
- Yeni sürümler, büyük güncellemeler, iyileştirmeler ve alt API'lerin kullanıma sunulması ve desteğinin sonlandırılması ile ilgili duyurular için sürüm notlarını ve son güncellemeleri düzenli olarak kontrol edin.
- Bir alt API'nin 2 veya daha fazla kararlı sürümü varsa her zaman en son sürümü kullanmanızı öneririz.
- Uygulamanızı, ağ sorunları, hız 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 ele alacak şekilde tasarlayın.
- Yükseltme planlamanızı, bir alt API sürümünün kullanımdan kaldırılmasına yakın bir zamana kadar beklemeyin. Yeni sürümler kullanıma sunulduğunda hemen değerlendirmeye ve test etmeye başlayın.
- Alt API yol haritasıyla ilgili özellik istekleri veya endişeleriniz için sorularınızı veya geri bildirimlerinizi bizimle paylaşın. Teknik destek almak için Merchant API Ekibi ile nasıl iletişime geçeceğiniz hakkında bilgi edinmek üzere Merchant API ile ilgili yardım alma başlıklı makaleyi inceleyin.