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 komponen atau layanan dalam Merchant API akan memiliki siklus proses versinya sendiri.
Format dan presentasi pembuatan versi
Versi sub-API stabil: Jika sub-API dalam versi stabil, semua metodenya akan 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 dalam versi alfa, semua metodenya akan dalam versi alfa. Versi sub-API alfa direpresentasikan sebagai vXalpha (misalnya, v1alpha, v2alpha). Ini adalah versi eksperimental akses awal yang ditujukan untuk pengujian dan iterasi cepat. Versi alfa tidak memiliki jaminan stabilitas dan tidak memiliki masa pakai yang dijamin. Versi alfa 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 minor: 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 mengganggu ke sub-API akan dirilis ke saluran alfa versi stabil terbaru atau langsung ke versi stabil terbaru.
Matahari Terbenam
Kami secara berkala menghentikan versi sub-API Merchant yang lebih lama. Kami berkomitmen untuk periode penghentian selama 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, sub-API versi sebelumnya tidak akan tersedia lagi untuk digunakan.
Versi sub-API dan status siklus proses
Tabel berikut mencantumkan versi terbaru setiap sub-API Merchant API:
| Sub-API | Versi alfa | Versi beta | Status |
|---|---|---|---|
| Akun | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Produk | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Input produk | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Inventaris lokal | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Inventaris regional | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Sumber data | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Promosi | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Laporan | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Konversi | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Notifikasi | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Ulasan | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Setelan pengiriman | Tidak tersedia | v1 beta | Versi beta v1 aktif |
| Product Studio | v1 alpha | Tidak tersedia | Versi alfa v1 aktif |
Praktik terbaik
- Periksa catatan rilis dan update terbaru secara berkala untuk mengetahui versi baru, update utama, peningkatan, dan pengumuman tentang peluncuran dan penghentian penggunaan sub-API.
- Jika sub-API memiliki 2 versi stabil atau lebih, sebaiknya gunakan versi terbaru selalu.
- Desain aplikasi Anda untuk menangani berbagai error sub-API dengan baik, termasuk masalah jaringan, batas kapasitas, 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 Anda. Mulai mengevaluasi dan menguji 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.