S52 Capstone 2 Added
parent
46a2e16bef
commit
ee9419584f
@ -1,140 +1,176 @@
|
|||||||
> Run: npm start
|
## E-COMMERCE API DOCUMENTATION
|
||||||
|
|
||||||
**** Stretch Goals ****
|
**_INSTALLATION COMMAND:_**
|
||||||
+ Set user as Admin ( Admin Only )
|
|
||||||
+ Retrieve Authenticated User's Orders
|
`npm install bcrypt cors dotenv express faker jsonwebtoken mongoose nodemon`
|
||||||
+ Retrieve all orders ( Admin Only )
|
|
||||||
+ Add to Cart ( Added Products, Change Product Quantities, Remove Products From Cart, Subtotal for each item, Total price for all items)
|
**_Start_**
|
||||||
+ Authentication Token with expiration (1hr)
|
npm start
|
||||||
+ dotenv
|
|
||||||
+ faker (Auto Generate Names)
|
**_TEST ACCOUNTS:_**
|
||||||
+ getUserDetails function ( Detects if the user tries to get the details of the other useId's + Token auth)
|
|
||||||
+ Middleware Secure verification that match Token and UserId to next()
|
- Regular User:
|
||||||
|
- email: user@email.com
|
||||||
**** Accounts ****
|
- pwd: user
|
||||||
|
- Admin User:
|
||||||
User: ( Password: wapatu )
|
- email: admin@email.com
|
||||||
{
|
- pwd: admin
|
||||||
"userId": "65544d9be5c01f6c0ca79200",
|
|
||||||
"email": "wapatu@example.com",
|
|
||||||
"firstName": "Estevan",
|
|
||||||
"lastName": "Cummings",
|
|
||||||
"isAdmin": false,
|
|
||||||
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NTU0NGQ5YmU1YzAxZjZjMGNhNzkyMDAiLCJlbWFpbCI6IndhcGF0dUBleGFtcGxlLmNvbSIsImlzQWRtaW4iOmZhbHNlLCJpYXQiOjE3MDAwMjM3MjQsImV4cCI6MTcwMDAyNzMyNH0.dpWV9Zx64TH4RLgmV_RlyrMBCa0HwDe9wJRAkwAyjys"
|
|
||||||
}
|
|
||||||
|
|
||||||
Admin: (Password is: admin )
|
|
||||||
{
|
|
||||||
"userId": "65535cb526b586a3e2fd56cc",
|
|
||||||
"email": "admin@email.com",
|
|
||||||
"isAdmin": true,
|
|
||||||
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NTUzNWNiNTI2YjU4NmEzZTJmZDU2Y2MiLCJlbWFpbCI6ImFkbWluQGVtYWlsLmNvbSIsImlzQWRtaW4iOnRydWUsImlhdCI6MTcwMDAyMzgxMSwiZXhwIjoxNzAwMDI3NDExfQ.DrhpNlBJKpfHod7MfTalQ5j2-s8tnR630yh2-_EIYWw"
|
|
||||||
}
|
|
||||||
|
|
||||||
**** Links ****
|
**_ROUTES:_**
|
||||||
|
|
||||||
REGISTER
|
- User registration (POST)
|
||||||
http://localhost:3000/user/register
|
- http://localhost:3000/user/register
|
||||||
--> Use post
|
- auth header required: NO
|
||||||
{
|
- request body:
|
||||||
|
{
|
||||||
"email": "admin@email.com",
|
"email": "admin@email.com",
|
||||||
"password": "admin"
|
"password": "admin"
|
||||||
}
|
}
|
||||||
|
|
||||||
LOGIN
|
- User authentication (POST)
|
||||||
http://localhost:3000/user/login
|
- http://localhost:3000/user/login
|
||||||
--> Use post
|
- auth header required: NO
|
||||||
{
|
- request body:
|
||||||
|
{
|
||||||
"email": "admin@email.com",
|
"email": "admin@email.com",
|
||||||
"password": "admin"
|
"password": "admin"
|
||||||
}
|
}
|
||||||
|
|
||||||
UPDATE PROFILE
|
- Create Product (Admin only) (POST)
|
||||||
http://localhost:3000/user/update
|
- http://localhost:4000/product/create
|
||||||
--> Must use Admin token // use put
|
- auth header required: YES
|
||||||
{
|
- request body:
|
||||||
"userId": "6554473388d9942bbf4de065",
|
{
|
||||||
"newEmail": "mundo@email.com",
|
|
||||||
"newFirstname": "Ron",
|
|
||||||
"newLastName": "Pogi",
|
|
||||||
"newPassword": "mundo"
|
|
||||||
}
|
|
||||||
|
|
||||||
CREATE PRODUCT [ADMIN]
|
|
||||||
http://localhost:3000/user/products
|
|
||||||
--> Must use Admin token // use post
|
|
||||||
{
|
|
||||||
"name": "Poring Card",
|
"name": "Poring Card",
|
||||||
"description": "Description unknown",
|
"description": "Description unknown",
|
||||||
"price": 500
|
"price": 500
|
||||||
}
|
}
|
||||||
|
|
||||||
GET ALL PRODUCT
|
- Update Profile
|
||||||
http://localhost:3000/user/all
|
- http://localhost:3000/user/update
|
||||||
--> Use get
|
- auth header required: YES
|
||||||
|
- request body:
|
||||||
GET ALL ACTIVE PRODUCT
|
{
|
||||||
http://localhost:3000/user/active
|
"userId": "",
|
||||||
--> Use get
|
"newEmail": "",
|
||||||
|
"newFirstname": "",
|
||||||
GET A SINGLE PROUCT
|
"newLastName": "",
|
||||||
http://localhost:3000/user/products/65538bd4a601aa30730f6d4c
|
"newPassword": ""
|
||||||
--> Use get
|
}
|
||||||
|
|
||||||
UPDATE A PRODUCT [ADMIN]
|
- Retrieve all products (Admin only) (GET)
|
||||||
http://localhost:3000/user/products/65545a1e6fa9d841e1518d1d
|
- http://localhost:3000/product/all
|
||||||
--> Must use Admin token // Use put
|
- auth header required: YES
|
||||||
{
|
- request body: none
|
||||||
|
|
||||||
|
- Retrieve all active products (GET)
|
||||||
|
- http://localhost:3000/product/active
|
||||||
|
- auth header required: NO
|
||||||
|
- request body: none
|
||||||
|
|
||||||
|
- Get all products (GET)
|
||||||
|
- http://localhost:3000/product/active
|
||||||
|
- auth header required: NO
|
||||||
|
- request body: none
|
||||||
|
|
||||||
|
- Get a product (GET)
|
||||||
|
- http://localhost:3000/product/products/65545a1e6fa9d841e1518d1d
|
||||||
|
- auth header required: YES
|
||||||
|
- request body: none
|
||||||
|
|
||||||
|
- Update Single product (PUT)
|
||||||
|
- http://localhost:3000/product/products/65545a1e6fa9d841e1518d1d
|
||||||
|
- auth header required: YES
|
||||||
|
- request body:
|
||||||
|
{
|
||||||
"name": "Christmas Cookie Card",
|
"name": "Christmas Cookie Card",
|
||||||
"description": "Updated Product Description",
|
"description": "Updated Product Description",
|
||||||
"price": 29.99,
|
"price": 29.99,
|
||||||
"isActive": false
|
"isActive": false
|
||||||
}
|
}
|
||||||
|
|
||||||
ACTIVATE / ARCHIVE A PRODUCT [ADMIN]
|
- Create Order (POST)
|
||||||
--> Use Put
|
- http://localhost:3000/user/order
|
||||||
http://localhost:3000/user/products/6554634e5cac4bcd6f2394ed/activate
|
- auth header required: YES
|
||||||
http://localhost:3000/user/products/6554634e5cac4bcd6f2394ed/archive
|
- request body:
|
||||||
|
{
|
||||||
|
"userId": "65535cb526b586a3e2fd56cc", // Replace with a valid user ID from your database
|
||||||
RETRIEVE OWN USER DATA
|
"products": [
|
||||||
--> Use Get
|
{
|
||||||
http://localhost:3000/user/retrieveUser
|
"productId": "6553a4e897ac8ac9462f96c4", // Replace with a valid product ID from your database
|
||||||
{
|
"productName": "Mastering Card",
|
||||||
|
"quantity": 1
|
||||||
"userId": "6554ac8dd7fbf9ee90217e77"
|
}
|
||||||
}
|
],
|
||||||
|
"totalAmount": 500
|
||||||
CART - Add to Cart
|
}
|
||||||
--> Must use token
|
|
||||||
http://localhost:3000/cart/add-to-cart
|
|
||||||
{
|
- Activate / Archive Product (PUT)
|
||||||
|
- auth header required: YES
|
||||||
|
- request body: none
|
||||||
|
- http://localhost:3000/product/products/6554634e5cac4bcd6f2394ed/activate
|
||||||
|
- http://localhost:3000/product/products/6554634e5cac4bcd6f2394ed/archive
|
||||||
|
|
||||||
|
- Set User to Admin (POST) [Admin Only]
|
||||||
|
- hhttp://localhost:3000/user/set-admin/
|
||||||
|
- auth header required: YES
|
||||||
|
- request body:
|
||||||
|
{
|
||||||
|
"userId":
|
||||||
|
}
|
||||||
|
|
||||||
|
- Retrieve All Orders [Admin Only] (GET)
|
||||||
|
- http://localhost:3000/user/orders-all
|
||||||
|
- auth header required: YES
|
||||||
|
- request body: none
|
||||||
|
|
||||||
|
- Add To Cart (POST)
|
||||||
|
- http://localhost:3000/cart/add-to-cart
|
||||||
|
- auth header required: YES
|
||||||
|
- request body:
|
||||||
|
{
|
||||||
"userId": "655396dcc8ea29f42422e214",
|
"userId": "655396dcc8ea29f42422e214",
|
||||||
"productId": "6553a54566c4c86c39034b55",
|
"productId": "6553a54566c4c86c39034b55",
|
||||||
"quantity": 5
|
"quantity": 5
|
||||||
}
|
}
|
||||||
|
|
||||||
CART - Delete Item
|
- Delete Item (DELETE)
|
||||||
http://localhost:3000/cart/remove-from-cart
|
- http://localhost:3000/cart/remove-from-cart
|
||||||
--> Must use token
|
- auth header required: YES
|
||||||
{
|
- request body:
|
||||||
|
{
|
||||||
"userId": "655396dcc8ea29f42422e214",
|
"userId": "655396dcc8ea29f42422e214",
|
||||||
"productId": "6553a55666c4c86c39034b59",
|
"productId": "6553a54566c4c86c39034b55",
|
||||||
"quantity": 1
|
"quantity": 5
|
||||||
}
|
}
|
||||||
|
|
||||||
CART - Update Quantity
|
- Update Quantity (PUT)
|
||||||
http://localhost:3000/cart//update-quantity
|
- http://localhost:3000/cart//update-quantity
|
||||||
--> Must use token
|
- auth header required: YES
|
||||||
{
|
- request body:
|
||||||
|
{
|
||||||
"userId": "655396dcc8ea29f42422e214",
|
"userId": "655396dcc8ea29f42422e214",
|
||||||
"productId": "6553a55666c4c86c39034b59",
|
"productId": "6553a55666c4c86c39034b59",
|
||||||
"quantity": 2000 // Update to the desired quantity
|
"quantity": 2000
|
||||||
}
|
}
|
||||||
|
|
||||||
CART - Cart Details [ Total ]
|
- Cart Total (GET)
|
||||||
--> Must use token
|
- http://localhost:3000/cart/cart-details
|
||||||
http://localhost:3000/cart/cart-details
|
- auth header required: YES
|
||||||
{
|
- request body:
|
||||||
|
{
|
||||||
"userId": "655396dcc8ea29f42422e214"
|
"userId": "655396dcc8ea29f42422e214"
|
||||||
}
|
}
|
||||||
|
|
||||||
|
\***\* Stretch Goals \*\***
|
||||||
|
|
||||||
|
- Set user as Admin ( Admin Only )
|
||||||
|
- Retrieve Authenticated User's Orders
|
||||||
|
- Retrieve all orders ( Admin Only )
|
||||||
|
- Add to Cart ( Added Products, Change Product Quantities, Remove Products From Cart, Subtotal for each item, Total price for all items)
|
||||||
|
- Authentication Token with expiration (1hr)
|
||||||
|
- dotenv
|
||||||
|
- faker (Auto Generate Names)
|
||||||
|
- getUserDetails function ( Detects if the user tries to get the details of the other useId's + Token auth)
|
||||||
|
- Middleware Secure verification that match Token and UserId to next()
|
||||||
|
|||||||
Loading…
Reference in New Issue