Hướng dẫn này giải thích cách Merchant API xử lý việc tạo phiên bản, bản phát hành và vòng đời của các phiên bản.
Lược đồ tạo phiên bản
Merchant API sử dụng chiến lược tạo phiên bản ở cấp độ API phụ. Điều này có nghĩa là mỗi Merchant API (ví dụ: Sản phẩm trong Merchant API) sẽ có vòng đời phiên bản riêng.
Định dạng và cách trình bày phiên bản
Phiên bản API phụ ổn định: Nếu một API phụ ở phiên bản ổn định thì tất cả các phương thức của API đó đều ở phiên bản ổn định. Phiên bản API phụ ổn định được biểu thị là vX (ví dụ: v1, v2). Đây là các phiên bản chính đã sẵn sàng cho môi trường thực tế.
Phiên bản API phụ alpha: Nếu một API phụ ở phiên bản alpha thì tất cả các phương thức của API đó đều ở phiên bản alpha. Phiên bản API phụ alpha được biểu thị là vXalpha (ví dụ: v1alpha, v2alpha). Các phiên bản này chứa các tính năng thử nghiệm, truy cập sớm dành cho việc thử nghiệm và lặp lại nhanh chóng. Phiên bản alpha không đảm bảo độ ổn định, không có thời gian tồn tại xác định và có thể được thay đổi hoặc ngừng cung cấp trong thời gian thông báo là 30 ngày.
Các lần thay đổi phiên bản
- Số lần tăng phiên bản lớn (ví dụ: v1 lên v2): Các phiên bản này báo hiệu các thay đổi không tương thích ngược và có thể gây lỗi, đòi hỏi nhà phát triển phải hành động. Chỉ những thay đổi có thể gây lỗi của API phụ ổn định mới có số phiên bản mới. Ví dụ: v1 lên v2.
- Các thay đổi nhỏ: Các tính năng bổ sung hoặc bản sửa lỗi tương thích ngược được trình bày dưới dạng các thay đổi đối với phiên bản lớn hiện có. Các thay đổi như vậy sẽ được trình bày chi tiết trong ghi chú phát hành cho phiên bản lớn đó. Các tính năng bổ sung không gây lỗi cho API phụ sẽ được phát hành cho kênh alpha của phiên bản ổn định mới nhất hoặc trực tiếp cho phiên bản ổn định mới nhất.
Chính sách ngừng cung cấp
Chúng tôi định kỳ ngừng cung cấp các phiên bản API phụ cũ của Merchant. Chúng tôi cam kết có khoảng thời gian ngừng cung cấp là 12 tháng cho các phiên bản chính ổn định (vX), bắt đầu từ thông báo ngừng cung cấp chính thức.
Ví dụ: nếu chúng tôi ngừng cung cấp phiên bản v1 của API phụ Sản phẩm vào ngày 15 tháng 1 năm 2026, thì phiên bản này sẽ ngừng cung cấp không sớm hơn ngày 15 tháng 1 năm 2027. Sau ngày này, bạn sẽ không còn sử dụng được phiên bản cũ của API phụ.
Trạng thái vòng đời và phiên bản API phụ
Bảng sau đây liệt kê các phiên bản mới nhất của từng API phụ của Merchant API:
| API phụ | Phiên bản | Trạng thái |
|---|---|---|
| Tài khoản | v1 v1alpha v1beta |
Đang hoạt động Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Lượt chuyển đổi | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Nguồn dữ liệu | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Khoảng không quảng cáo | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Giải quyết vấn đề | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Quan hệ đối tác về nguồn cấp dữ liệu địa phương | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Dịch vụ thông báo | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Theo dõi đơn đặt hàng | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Sản phẩm | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Product Studio | v1alpha | Đang hoạt động |
| Khuyến mãi | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Quota | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Báo cáo | v1 v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
| Bài đánh giá | v1alpha v1beta |
Đang hoạt động Ngừng cung cấp vào ngày 28 tháng 2 năm 2026 |
Các phương pháp hay nhất
- Thường xuyên kiểm tra ghi chú phát hành và thông tin cập nhật mới nhất để biết các phiên bản mới, bản cập nhật chính, cải tiến và thông báo về việc ra mắt và ngừng cung cấp API phụ.
- Nếu một API phụ có từ hai phiên bản ổn định trở lên, bạn nên luôn sử dụng phiên bản mới nhất.
- Thiết kế ứng dụng của bạn để xử lý một cách hiệu quả nhiều lỗi API phụ, bao gồm cả vấn đề về mạng, giới hạn tốc độ và mã lỗi hoặc thông báo lỗi mới có thể được giới thiệu trong các phiên bản API phụ mới hơn.
- Đừng đợi đến khi một phiên bản API phụ sắp ngừng cung cấp mới bắt đầu lên kế hoạch nâng cấp. Hãy bắt đầu đánh giá và thử nghiệm các phiên bản mới ngay khi chúng được cung cấp.
- Nếu bạn có yêu cầu về tính năng hoặc thắc mắc về lộ trình API phụ, hãy liên hệ với chúng tôi để đặt câu hỏi hoặc gửi ý kiến phản hồi. Để biết thông tin về cách liên hệ với nhóm Merchant API để được hỗ trợ kỹ thuật, hãy xem bài viết Nhận trợ giúp về Merchant API.