Giới thiệu

Ajax API cung cấp một số địa chỉ api bổ sung cho phát triển giao diện.

Ví dụ trường hợp sử dụng Ajax API:

• Thêm sản phẩm vào giỏ hàng và cập nhật số lượng item trong giỏ hàng

Ajax API chỉ nên được sử dụng bởi giao diện trên site

Tạo request

Ajax API chấp nhận 2 loại http request:

• GET: Lấy thông tin giỏ hàng, sản phẩm
• POST: Cập nhật thông tin giỏ hàng cho phiên hiện tại

Ví dụ, để lấy thông tin giỏ hàng hiện tại gọi client-side request tới địa chỉ api /cart.js của cửa hàng

jQuery.getJSON("/cart.js", function (cart) {
  // do some thing with cart
})

Đối với POST request, api chấp nhận cả body gửi lên ở dạng json hoặc ở dạng form data. Khi ở dạng json, tên các trường sẽ ở dạng snake_case. Khi ở dạng form data, tên các trường ở dạng CamelCase.

Ví dụ thêm item có variant id là 17581931 và thuộc tính first name là An vào giỏ hàng

Đối với json POST:

jQuery.ajax({
    url: '/cart/add.js',
    type: 'post',
    dataType: 'json',
    contentType: 'application/json',
    success: function (data) {
      // do something with data
    },
    data: JSON.stringify({
      variant_id: 17581931,
      quantity: 1,
      properties: {
        'first name': 'An'
      }
    })
});

Đối với form data POST:

jQuery.post('/cart/add.js', {
  variantId: 17581931,
  quantity: 1,
  properties: {
    'first name': 'An'
  }
}, function (data) {
    // do something with data
});

Một số lưu ý

• API là không yêu cầu xác thực, không yêu cầu bất kì access token hay client-id nào để truy cập
• Tất cả API đều trả về định dạng json
• Không thể sử dụng api này để đọc thông tin về khách hàng, đơn hàng hay cập nhật thông tin cửa hàng. Trong trường hợp đó hãy sử dụng Admin API