Cart

This page contains the documentation for the cart endpoints.

The cart endpoints allow you to add items in your cart and look at what you currently have in there. You can also modify the number of items and remove items in the cart.

Add Items to Cart

post

https://thefurniturebros.comhttps://localhost:5000

/cart/add

This endpoint allows you add items to your cart.

Authorizations

APIKey

AuthorizationstringRequired

Provide your API key.

Body

application/json

productIdstringRequired

The ID of the product. You can use the GET Product list endpoint to view available products and it's ID.

quantityintegerRequired

The quantity of items to add.

Responses

200

Successful response. Returns the result of the operation.

text/plain

stringOptional

Successful operation.

Example: POST REQUEST SUCCESS

400

See message description.

500

see message description.

post

/cart/add

HTTPcURLJavaScriptPython

POST /cart/add HTTP/1.1
Host: thefurniturebros.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "productId": "6555a1f49feeac7dccd9b1ee",
  "quantity": 20
}

POST REQUEST SUCCESS

Get Cart Items

get

https://thefurniturebros.comhttps://localhost:5000

/cart/items

This endpoint allows you get the current items in your cart.

Authorizations

APIKey

AuthorizationstringRequired

Provide your API key.

Responses

200

Successful response. Returns the list of items in your cart.

application/json

_idstringOptional

Unique identifier for the order

__vintegerOptional

The version of the cart. The version increases whenever the cart is modified.

400

See message description.

500

see message description.

get

/cart/items

HTTPcURLJavaScriptPython

GET /cart/items HTTP/1.1
Host: thefurniturebros.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "_id": "6556aed27e6cd0b318dbb08d",
  "user": {
    "_id": "6555a0f89feeac7dccd9b1dd",
    "name": "first account",
    "email": "[email protected]"
  },
  "items": [
    {
      "product": {
        "_id": "6555a2269feeac7dccd9b1f2",
        "name": "White desk",
        "image": "1700110886749.webp",
        "price": 60,
        "description": "Maecenas at justo eu eros ultrices vulputate vitae at augue.",
        "soldCount": 99,
        "__v": 0
      },
      "quantity": 20,
      "_id": "67498e75990ee7506c8ee954"
    },
    {
      "product": {
        "_id": "655fefee60b5a0bcc0a9313c",
        "name": "stool",
        "image": "1700786158091.webp",
        "price": 60,
        "description": "Umde",
        "soldCount": 1,
        "__v": 0
      },
      "quantity": 25,
      "_id": "67498e82990ee7506c8ee958"
    }
  ],
  "__v": 100
}

Edit Cart Items

put

https://thefurniturebros.comhttps://localhost:5000

/cart/edit

This endpoint allows you to update the quantity of a product in the cart.

Authorizations

APIKey

AuthorizationstringRequired

Provide your API key.

Body

application/json

productIdstringRequired

Unique identifier of the product to update.

quantityintegerRequired

New quantity of the product.

Responses

200

Successful response. Returns the items in the cart.

application/json

_idstringOptional

Unique identifier for the cart.

userstringOptional

Unique identifier for the user who owns the cart.

__vintegerOptional

The version of the cart. The version increases whenever the cart is modified.

400

See message description.

500

see message description.

put

/cart/edit

HTTPcURLJavaScriptPython

PUT /cart/edit HTTP/1.1
Host: thefurniturebros.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "productId": "655fefee60b5a0bcc0a9313c",
  "quantity": 40
}

{
  "_id": "6556aed27e6cd0b318dbb08d",
  "user": "6555a0f89feeac7dccd9b1dd",
  "items": [
    {
      "product": "6555a2269feeac7dccd9b1f2",
      "quantity": 30,
      "_id": "67498e75990ee7506c8ee954"
    },
    {
      "product": "655fefee60b5a0bcc0a9313c",
      "quantity": 40,
      "_id": "67498e82990ee7506c8ee958"
    }
  ],
  "__v": 100
}

Remove Items from Cart

delete

https://thefurniturebros.comhttps://localhost:5000

/cart/delete

This endpoint allows you to delete specified items from the user's cart.

Authorizations

APIKey

AuthorizationstringRequired

Provide your API key.

Body

application/json

itemsstring[]Optional

List of product IDs to remove from the cart.

Responses

200

Successful response. Returns the updated cart after deletion.

application/json

_idstringOptional

Unique identifier for the cart.

userstringOptional

Unique identifier for the user who owns the cart.

__vintegerOptional

The version of the cart. The version increases whenever the cart is modified.

400

See message description.

500

see message description.

delete

/cart/delete

HTTPcURLJavaScriptPython

DELETE /cart/delete HTTP/1.1
Host: thefurniturebros.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "items": [
    "67498e75990ee7506c8ee954"
  ]
}

{
  "_id": "6556aed27e6cd0b318dbb08d",
  "user": "6555a0f89feeac7dccd9b1dd",
  "items": [
    {
      "product": "655fefee60b5a0bcc0a9313c",
      "quantity": 40,
      "_id": "67498e82990ee7506c8ee958"
    },
    {
      "product": "65653baad868691c42306f7f",
      "quantity": 41,
      "_id": "6749904c990ee7506c8ee97d"
    }
  ],
  "__v": 101
}