Nâng cấp lên v3.0
API v3.0 chuẩn bị ra mắt, v3.0 thay đổi lại cấu trúc dữ liệu giúp đọc các params và response rõ ràng hơn, bổ sung thêm nhiều API và webhooks mới.
Sau khi chính thức ra mắt v3.0, hệ thống sẽ ngừng hỗ trợ bản 2.0 sau 12 tháng.
Các thay đổi cần chú ý
Access Token
Các accessToken và quyền đã được cấp ở v2 sẽ vẫn được dùng cho v3 Alpha. Bản chính thức có thể sẽ tách hoàn toàn accessToken 2 bản v2.0, v3.0.
Cài đặt app sẽ có thêm 1 mục webhooks version: Bạn có thể chọn nhận webhooks v2 hoặc v3.
Request
Khác với v2.0 dùng Body form-data, v3.0 đã dùng hoàn toàn JSON và truyền qua Body raw. Xem các thay cách tạo request params tại đây.
v3.0 đã hỗ trợ mở CORS, không còn chặn gọi bằng Javascript như v2.0
Response.
API v3.0 đã thay đổi hoàn toàn cấu trúc dữ liệu response data. Bạn chú ý đọc kỹ tài liệu ở từng API.
cấu trúc dữ liệu ở mục Webhooks, sẽ giồng với dữ liệu ở các trang danh sách giúp giảm tải việc gọi lại API lấy thông tin. VD
Webhooks nhận thông tin sản phẩm, sẽ có cấu trúc giống với 1 sản phẩm trong danh sách bạn gọi API lấy danh sách sản phẩm
Các API mới
Dự kiến API v3 sẽ hỗ trợ thêm các mục sau:
POS
Báo cáo: Lấy 1 số báo cáo thường dùng.
Bán hàng:
Thêm hóa đơn bán lẻ, bán sỉ
Lấy danh sách hóa đơn đã bị xóa
Đơn hàng:
Lấy danh sách đơn hàng đã bị xóa
Kho hàng: Thêm 1 số loại phiếu xuất nhập kho
Khuyến mại:
Tặng điểm, trừ điểm khách hàng
Tặng coupon
Webhooks:
Vpage
v3.0 đã mở API cho Vpage.nhanh.vn.
Xem API của Vpage tại đây.
Các Webhooks mới
Đang cập nhật.
Last updated