Git Product home page Git Product logo

shopping-cart-rest-api's Introduction

Shopping-Cart-REST-API

DESCRIPTION

  • Built a REST Api in Node.js using MVC approch by leveraging Node.js + MongoDB.
  • User JWT for Authetication and Authorization.
  • A RESTful Api built for serving as a Backend for a Shopping Cart.

REQUIREMENTS

  • Node.js 10.12.0
  • MongoDb

INSTALLATION INSTRUCTIONS

  • Clone or download the repo. into any fresh temporary folder.

  • Cd into that root folder you just cloned locally.

  • Open terminal in the current folder and to install all dependencies type

    npm install
    
  • Now typing

    npm start
    

    will start a server !

    App should now be running on localhost:3000

Dependencies

  • For dependencies refer Package.json

For Testing (Postman)

  • Postman extension can be used for testing !
  • Supercharge your API workflow with Postman! Build, test, and document your APIs faster.
  • You can now fire up postman and then perform several operations on the REST API.

Available API Routes

Routes Description
GET/products/ Get list of all products
POST/products/ Post a new product
GET/products/:productId Get details of a particular product.
PATCH/products/:productId Update a particular product
DELETE/products/:productId Delete a particular product
Routes Description
POST/user/signup Sign up a new user
POST/user/login Login a user
DELETE/user/:userId Delete a user from database
Routes Description
GET/orders/ Get all orders by the logged in user
POST/orders/ Post a new order for the logged in user
GET/orders/:orderId Fetch details of a particular order
DELETE/orders/:orderId Deletes a particular order

1. Product Routes

A. Get list of all Products.

Send Get request to fetch the list of Orders in JSON format..

Method: GET 
URL: /products/
Produces: application/json

Example :

  • Request : /products/

  • Response:

    {
    "count": 3,
    "products": [
        {
            "_id": "5bdd9d946d97be54a4dc5666",
            "name": "Book",
            "price": 100,
            "request": {
                "type": "GET",
                "descripption": "Get details of the product.",
                "url": "http://localhost:3000/products/5bdd9d946d97be54a4dc5666"
            }
        },
        {
            "_id": "5bdda09560e88d867454fea3",
            "name": "Mobile",
            "price": 1800,
            "request": {
                "type": "GET",
                "descripption": "Get details of the product.",
                "url": "http://localhost:3000/products/5bdda09560e88d867454fea3"
            }
        },
        {
            "_id": "5bddbd3a3ab5bb2184a14764",
            "name": "headphones",
            "price": 300,
            "request": {
                "type": "GET",
                "descripption": "Get details of the product.",
                "url": "http://localhost:3000/products/5bddbd3a3ab5bb2184a14764"
            }
        }
      ]
    }
    

B. Post a new product

User must be logged in to do that.

Method: POST
URL: /products/
Authorization: Bearer {token}
Produces: application/json

Parameters :

Field Type Required Description
name String Required Name of the product
price String Required Price of the product

Example :

  • Request: /products/

  • Response:

{
    "message": "Product Created Successfully!!",
    "createdProduct": {
        "_id": "5c21e3f5c6cfb46d8c51b616",
        "name": "laptop",
        "price": 50000,
        "request": {
            "type": "GET",
            "description": "Get details of the product",
            "url": "http://localhost:3000/products/5c21e3f5c6cfb46d8c51b616"
        }
    }
}

C. Get details of a particular product

Method: GET
URL: /products/:productId
Produces: application/json

Example :

  • Request: /products/5c21e3f5c6cfb46d8c51b616

  • Response:

{
    "product": {
        "_id": "5c21e3f5c6cfb46d8c51b616",
        "name": "laptop",
        "price": 50000
    },
    "request": {
        "type": "GET",
        "description": "Get list of all products",
        "url": "http://localhost:3000/products"
    }
}

D. Update a particular product

User must be logged in to do that.

Parameters :

Field Type Required Description
name String Not Updated name of the product
price String Not Updated price of the product

Request Body :

[
	{
		"propName":"name",
		"value":"T.V"
	},
  {
		"propName":"price",
		"value":"20000"
	}	
]
Method: PATCH
URL: /products/:productId
Authorization: Bearer {token}
Produces: application/json

Example :

  • Request: /products/5c21e3f5c6cfb46d8c51b616

  • Response:

{
    "message": "Product Updated Successfully",
    "request": {
        "type": "GET",
        "description": "Get product details.",
        "url": "http://localhost:3000/products/5bdd9d946d97be54a4dc5666"
    }
}

E. Delete a particular product

User must be logged in to do that.

Method: DELETE
URL: /products/:productId
Authorization: Bearer {token}
Produces: application/json

Example :

  • Request: /products/5c21e3f5c6cfb46d8c51b616

  • Response:

{
    "message": "Product Deleted",
    "request": {
        "type": "POST",
        "description": "Create new Product",
        "url": "http://localhost:3000/products",
        "body": {
            "name": "String",
            "price": "Number"
        }
    }
}

2. User Routes

A. Sign up a new User.

Sends a POST request to create a new user and returns a web token for further authentication.

Method: POST 
URL: /user/signup
Produces: application/json

Parameters :

Field Type Required Description
email Email Required User Email
password String Required password

Example :

  • Request : /user/signup

  • Response:

    {
      "message": "User Successfully Created!!"
    }
    

B. Login a existing user

Sends a POST request to login a exisiting user

Method: POST
URL: /user/login
Produces: application/json

Parameters :

Field Type Required Description
email Email Required User Email
password String Required password

Example :

  • Request: /user/login

  • Response:

      {
        "message": "Auth Successful!!",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6ImthbHBpdEB0ZXN0LmNvbSIsIklkIjoiNWMyMWUxNGRjNmNmYjQ2ZDhjNTFiNjE1IiwiaWF0IjoxNTQ1NzI0MjcyLCJleHAiOjE1NDU3Mjc4NzJ9.0Ro0iBOO0I_mEjYHhQHPhXy0JmP_iAYhgZAHI3a4vkI"
      }

C. Delete a user

Method: DELETE
URL: /user/:userId
Produces: application/json

Example :

  • Request: /user/:userId

  • Response:

{
	"message":'User successfully deleted!!'
}

3. Order Routes

A. Get list of all Orders.

Send Get request to fetch the list of Orders by a User in JSON format. User must be logged in to do that

Method: GET 
URL: /orders/
Authorization: Bearer {token}
Produces: application/json

Example :

  • Request : /orders/

  • Response:

    {
    "count": 3,
    "orders": [
        {
            "_id": "5c21f7d6c6cfb46d8c51b61a",
            "product": {
                "_id": "5bdda09560e88d867454fea3",
                "name": "Mobile",
                "price": 1800
            },
            "request": {
                "type": "GET",
                "description": "Get details of the product",
                "url": "http://localhost:3000/orders/5c21f7d6c6cfb46d8c51b61a"
            }
        },
        {
            "_id": "5c21f87ec6cfb46d8c51b61b",
            "product": {
                "_id": "5bddbd3a3ab5bb2184a14764",
                "name": "headphones",
                "price": 300
            },
            "request": {
                "type": "GET",
                "description": "Get details of the product",
                "url": "http://localhost:3000/orders/5c21f87ec6cfb46d8c51b61b"
            }
        },
        {
            "_id": "5c21f89dc6cfb46d8c51b61c",
            "product": {
                "_id": "5bde81bf8a45ecca5cfac6ff",
                "name": "AC",
                "price": 4000
            },
            "request": {
                "type": "GET",
                "description": "Get details of the product",
                "url": "http://localhost:3000/orders/5c21f89dc6cfb46d8c51b61c"
            }
        }
      ]
    }
    

B. Post a new order

User must be logged in to do that.

Method: POST
URL: /orders/
Authorization: Bearer {token}
Produces: application/json

Parameters :

Field Type Required Description
productId String Required Id of the product to be ordered
quantity integer Required Quantity

Example :

  • Request: /orders/

  • Response:

{
    "message": "Order Successfully Placed",
    "createdOrder": {
        "_id": "5c21f7d6c6cfb46d8c51b61a",
        "product": "5bdda09560e88d867454fea3",
        "quantity": 5
    },
    "request": {
        "type": "GET",
        "description": "Get details of the order",
        "url": "http://localhost:3000/orders/5c21f7d6c6cfb46d8c51b61a"
    }
}

C. Get details of a particular order

User must be logged in to do that

Method: GET
URL: /orders/:orderId
Authorization: Bearer {token}
Produces: application/json

Example :

  • Request: /orders/5c21f7d6c6cfb46d8c51b61a

  • Response:

{
    "order": {
        "quantity": 5,
        "_id": "5c21f7d6c6cfb46d8c51b61a",
        "product": {
            "_id": "5bdda09560e88d867454fea3",
            "name": "Mobile",
            "price": 1800
        },
        "__v": 0
    },
    "request": {
        "type": "GET",
        "description": "Get all Orders",
        "url": "http://localhost:3000/orders/"
    }
}

D. Delete a particular order

User must be logged in to do that.

Method: DELETE
URL: /orders/:orderId
Authorization: Bearer {token}
Produces: application/json

Example :

  • Request: /orders/5c21f89dc6cfb46d8c51b61c

  • Response:

{
    "message": "Order Deleted",
    "request": {
        "type": "POST",
        "description": "Place new Order",
        "url": "http://localhost:3000/orders/"
    }
}

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.