Hướng dẫn nodejs shopping cart api - api giỏ hàng nodejs

Shopping Cart RESTful API

Phần Backend của ứng dụng Shopping Cart được viết bằng NodeJS [Typescript], cơ sở dữ liệu MongoDB và được deploy bằng Docker

Bắt đầu

Hướng dẫn này sẽ giúp bạn tạo một bản copy của project và chạy nó ở máy local của bạn

Tải về và cài đặt

Để lấy project về máy local, bạn có thể dùng git [link tải git] hoặc tải về một bản nén. Để clone bằng git,bạn dùng lệnh sau:

git clone //github.com/HieuDevX/shopping-cart-node-api.git

Để chạy được project bạn cần cài đặt Docker theo link này, đảm bảo bạn đã cài docker và docker-compose bằng 2 lệnh sau

Chạy

Truy cập vào thư mục source code của ứng dụng:

• Môi trường development, chạy lệnh sau, ứng dụng run ở localhost:3002/

docker-compose -f docker-compose.dev.yml -p shopping-dev up -d

• Môi trường production, chạy lần lượt 2 lệnh sau, ứng dụng run ở localhost:3001/

yarn build or npm run build

docker-compose -p shopping-prod up -d

Các API hiện tại

Để lấy tất cả các categories:

Ví dụ: GET: //localhost:3001/categories

{
  "data": [
    {
      "_id": "5c25bb28c23c56362f18ada4",
      "name": "XXXX",
      "price": 55.233,
      "image": "/static/img/category/category1.jpg"
    },
    ...{
      "_id": "5c25bb28c23c56362f18ada5",
      "name": "Zamit",
      "price": 44.926,
      "image": "/static/img/category/category3.jpg"
    }
  ]
}

Để lấy categories theo id:

GET: /categories/:categoryId

Ví dụ: GET: //localhost:3001/categories/5c25bb28c23c56362f18ada4

{
  "data": {
    "_id": "5c25bb28c23c56362f18ada4",
    "name": "XXXX",
    "price": 55.233,
    "image": "/static/img/category/category1.jpg"
  }
}

Để lấy tất cả products:

Ví dụ: //localhost:3001/products

{
  "data": [
    {
      "image": [
        "/static/img/product/pro-big-1.jpg",
        "/static/img/product/pro-big-2.jpg",
        "/static/img/product/pro-big-3.jpg"
      ],
      "_id": "5c25bb28c23c56362f18adad",
      "name": "Angil",
      "price": 2000,
      "status": true,
      "description": "Phone 6 là một trong những smartphone được yêu thích nhất của Apple. Lắng nghe nhu cầu về thiết kế, khả năng lưu trữ và giá cả, iPhone 6 32GB được chính thức phân phối chính hãng tại Việt Nam hứa hẹn sẽ là một sản phẩm rất HOT",
      "imageSub": "/static/img/product/pro-big-1.jpg",
      "categoryId": "5c25bb28c23c56362f18ada4"
    },
    ...{
      "image": [
        "/static/img/product/pro-big-4.jpg",
        "/static/img/product/product1.jpg",
        "/static/img/product/product2.jpg"
      ],
      "_id": "5c25bb28c23c56362f18adae",
      "name": "Cherie",
      "price": 2000,
      "status": true,
      "description": "Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aliquid quae eveniet culpa officia quidem mollitia impedit iste asperiores nisi reprehenderit consequatur, autem, nostrum pariatur enim?",
      "imageSub": "/static/img/product/pro-big-4.jpg",
      "categoryId": "5c25bb28c23c56362f18ada4"
    }
  ]
}

Để lấy product theo id

GET: /products/:productId

Ví dụ: GET //localhost:3001/products/5c25bb28c23c56362f18adad

{
  "data": {
    "image": [
      "/static/img/product/pro-big-1.jpg",
      "/static/img/product/pro-big-2.jpg",
      "/static/img/product/pro-big-3.jpg"
    ],
    "_id": "5c25bb28c23c56362f18adad",
    "name": "Angil",
    "price": 2000,
    "status": true,
    "description": "Phone 6 là một trong những smartphone được yêu thích nhất của Apple. Lắng nghe nhu cầu về thiết kế, khả năng lưu trữ và giá cả, iPhone 6 32GB được chính thức phân phối chính hãng tại Việt Nam hứa hẹn sẽ là một sản phẩm rất HOT",
    "imageSub": "/static/img/product/pro-big-1.jpg",
    "categoryId": "5c25bb28c23c56362f18ada4"
  }
}

Để lấy các product theo categoryId

docker-compose -f docker-compose.dev.yml -p shopping-dev up -d

Ví dụ: GET //localhost:3001/products/byCategory/5c25bb28c23c56362f18ada4

{
  "data": [
    {
      "image": [
        "/static/img/product/pro-big-1.jpg",
        "/static/img/product/pro-big-2.jpg",
        "/static/img/product/pro-big-3.jpg"
      ],
      "_id": "5c25bb28c23c56362f18adad",
      "name": "Angil",
      "price": 2000,
      "status": true,
      "description": "Phone 6 là một trong những smartphone được yêu thích nhất của Apple. Lắng nghe nhu cầu về thiết kế, khả năng lưu trữ và giá cả, iPhone 6 32GB được chính thức phân phối chính hãng tại Việt Nam hứa hẹn sẽ là một sản phẩm rất HOT",
      "imageSub": "/static/img/product/pro-big-1.jpg",
      "categoryId": "5c25bb28c23c56362f18ada4"
    },
    ...{
      "image": [
        "/static/img/product/pro-big-4.jpg",
        "/static/img/product/product1.jpg",
        "/static/img/product/product2.jpg"
      ],
      "_id": "5c25bb28c23c56362f18adae",
      "name": "Cherie",
      "price": 2000,
      "status": true,
      "description": "Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aliquid quae eveniet culpa officia quidem mollitia impedit iste asperiores nisi reprehenderit consequatur, autem, nostrum pariatur enim?",
      "imageSub": "/static/img/product/pro-big-4.jpg",
      "categoryId": "5c25bb28c23c56362f18ada4"
    }
  ]
}