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

Các Webhooks mới

  • Đang cập nhật.

Last updated