Panduan ini menjelaskan cara Merchant API menangani pembuatan versi, rilis, dan siklus proses berbagai versinya.
Skema pembuatan versi
Merchant API menggunakan strategi pembuatan versi di tingkat sub-API. Artinya, setiap Merchant API, misalnya Produk dalam Merchant API, akan memiliki siklus proses versinya sendiri.
Format dan presentasi pembuatan versi
Versi sub-API stabil: Jika sub-API berada dalam versi stabil, semua metodenya berada dalam versi stabil. Versi sub-API stabil direpresentasikan sebagai vX (misalnya, v1, v2). Ini adalah versi utama yang siap produksi.
Versi sub-API alfa: Jika sub-API berada dalam versi alfa, semua metodenya berada dalam versi alfa. Versi sub-API alfa direpresentasikan sebagai vXalpha (misalnya, v1alpha, v2alpha). Versi ini berisi fitur akses awal eksperimental yang ditujukan untuk pengujian dan iterasi cepat. Versi alfa tidak memiliki jaminan stabilitas, tidak memiliki masa aktif yang ditentukan, dan dapat diubah atau dihentikan dengan periode pemberitahuan 30 hari.
Perubahan versi
- Penambahan versi utama (misalnya, v1 ke v2): Perubahan ini menandakan perubahan yang tidak kompatibel dengan versi sebelumnya dan perubahan yang dapat menyebabkan gangguan, yang memerlukan tindakan developer. Hanya perubahan yang dapat menyebabkan gangguan pada sub-API stabil yang akan memiliki nomor versi baru. Misalnya, v1 ke v2.
- Perubahan kecil: Penambahan atau perbaikan yang kompatibel dengan versi sebelumnya ditampilkan sebagai perubahan pada versi utama yang ada. Perubahan tersebut akan dijelaskan dalam catatan rilis untuk versi utama tersebut. Penambahan yang tidak menyebabkan gangguan pada sub-API akan dirilis ke saluran alfa versi stabil terbaru atau langsung ke versi stabil terbaru.
Kebijakan penghentian
Kami secara berkala menghentikan penggunaan versi sub-API Merchant yang lebih lama. Kami berkomitmen untuk memberikan jangka waktu penghentian 12 bulan untuk versi utama stabil (vX), mulai dari pengumuman penghentian resmi.
Misalnya, jika kami menghentikan penggunaan sub-API Produk v1 pada 15 Januari 2026, sub-API tersebut akan dihentikan paling cepat pada 15 Januari 2027. Setelah tanggal ini, versi sub-API sebelumnya tidak akan tersedia lagi untuk digunakan.
Status versi dan siklus proses sub-API
Tabel berikut mencantumkan versi terbaru dari setiap sub-API Merchant API:
| Sub-API | Versi | Status |
|---|---|---|
| Akun | v1 v1alpha v1beta |
Aktif Aktif Dihentikan pada 28 Februari 2026 |
| Konversi | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Sumber data | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Inventaris | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Penyelesaian masalah | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Kemitraan feed lokal | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Notifikasi | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Pelacakan pesanan | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Produk | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Product Studio | v1alpha | Aktif |
| Promosi | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Quota | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Laporan | v1 v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
| Ulasan | v1alpha v1beta |
Aktif Dihentikan pada 28 Februari 2026 |
Praktik terbaik
- Periksa catatan rilis dan update terbaru secara rutin untuk mengetahui versi baru, update utama, peningkatan, dan pengumuman tentang peluncuran dan penghentian sub-API.
- Jika sub-API memiliki dua versi stabil atau lebih, sebaiknya gunakan versi terbaru setiap saat.
- Desain aplikasi Anda untuk menangani berbagai error sub-API dengan baik, termasuk masalah jaringan, batas frekuensi, dan kode atau pesan error baru yang mungkin diperkenalkan dengan versi sub-API yang lebih baru.
- Jangan menunggu hingga versi sub-API akan dihentikan untuk mulai merencanakan upgrade. Mulai evaluasi dan uji versi baru segera setelah tersedia.
- Untuk permintaan fitur atau masalah terkait roadmap sub-API, hubungi kami dengan pertanyaan atau masukan. Untuk mengetahui informasi tentang cara menghubungi tim Merchant API untuk mendapatkan dukungan teknis, lihat Mendapatkan bantuan terkait Merchant API.