BootCamper API

Backend API for a bootcamp company to manage bootcamps, courses, reviews, users and authentication

Run this API locally

• Clone the repo
• run cmd - npm install
• Place your own mongo URI from mLab in config/config.env file
• run cmd - npm run dev

Indices

• Bootcamps

  • Get all Bootcamps
  • Get Single Bootcamps
  • Create a Bootcamp
  • Update a Bootcamp
  • Delete a Bootcamp
  • Get all Bootcamps by distance
  • Pagination
  • Photo upload

• Courses

  • Get all Courses
  • Get Courses by Bootcamp
  • Create a Course
  • Update a Courses
  • Delete a Courses

• Authentication

  • Register user
  • Login
  • Get LoggedIn user
  • Forgot Password
  • Reset Password
  • Update User
  • Change Password
  • Logout user

• Users

  • Get Users
  • Get a single User
  • Create a user
  • Update user
  • Delete User

• Reviews

  • Get reviews
  • Get reviews by Bootcamp
  • Get Single reviews
  • Add review
  • Update review
  • Delete review

Bootcamps

Bootcamps CRUD functionality

1. Get all Bootcamps

Fetch all bootcamps from Databases which includes pagination, filtering etc

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/bootcamps/

2. Get Single Bootcamps

Fetch single bootcamp from Database

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/bootcamps/5e90e8f05bddbb3bc075a455

Headers:

3. Create a Bootcamp

Add a bootcamp in the Database. User must be authenticated and have publisher or admin access.

Endpoint:

Method: POST
Type: RAW
URL: {{URL}}/api/v1/bootcamps

Headers:

Body:

{		"name": "React Bootcamp",
		"description": "Devworks is a full stack JavaScript Bootcamp located in the heart of Boston that focuses on the technologies you need to get a high paying job as a web developer",
		"website": "https://devworks.com",
		"phone": "(111) 111-1111",
		"email": "[email protected]",
		"address": "233 Bay State Rd Boston MA 02215",
		"careers": ["Web Development", "UI/UX", "Business"],
		"housing": true,
		"jobAssistance": true,
		"jobGuarantee": false,
		"acceptGi": true
}

4. Update a Bootcamp

Update a specific bootcamp by ID in the Database

Endpoint:

Method: PUT
Type: RAW
URL: {{URL}}/api/v1/bootcamps/5e5ac0537380631790dc58a4

Headers:

Body:

{
	 "name": "Edu-Uncle Bootcamp"
}

5. Delete a Bootcamp

Delete a bootcamp permanantly from the database.

Endpoint:

Method: DELETE
Type: 
URL: {{URL}}/api/v1/bootcamps/5e90e8f05bddbb3bc075a455

6. Get all Bootcamps by distance

Get Bootcamps within a radius of specific zipcode

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/bootcamps/radius/02118/10

Headers:

7. Pagination

Get Bootcamp by Pagination

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/bootcamps

Headers:

Query params:

8. Photo upload

Upload a photo for a specific bootcamp

Endpoint:

Method: PUT
Type: RAW
URL: {{URL}}/api/v1/bootcamps/5d725a1b7b292f5f8ceff788/photo

Headers:

Body:

{
	 "name": "Edu-Uncle Bootcamp"
}

Courses

Create , Read , Update and Delete Course

1. Get all Courses

Get all courses API

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/courses

Headers:

2. Get Courses by Bootcamp

Get all the courses belongs to a particular bootcamp.

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/bootcamps/5d725a1b7b292f5f8ceff788/courses

Headers:

3. Create a Course

Create a course in a particular bootcamp by providing the bootcamp ID

Endpoint:

Method: POST
Type: RAW
URL: {{URL}}/api/v1/bootcamps/5d713a66ec8f2b88b8f830b8/courses

Body:

{
		"title": "React Development",
		"description": "In this course you will learn full stack web development, first learning all about the frontend with HTML/CSS/JS/Vue and then the backend with Node.js/Express/MongoDB",
		"weeks": 12,
		"tuition": 12000,
		"minimumSkill": "intermediate",
		"scholarhipsAvailable": true,
		"user": "5d7a514b5d2c12c7449be045"
}

4. Update a Courses

Update a course by their ID

Endpoint:

Method: PUT
Type: RAW
URL: {{URL}}/api/v1/courses/5d725a4a7b292f5f8ceff789

Body:

{
	"title":"React Developer"
}

5. Delete a Courses

Remove a course by their ID

Endpoint:

Method: DELETE
Type: 
URL: {{URL}}/api/v1/courses/5d725a4a7b292f5f8ceff789

Authentication

Routes for user Authentication

1. Register user

Route for registering a user

Endpoint:

Method: POST
Type: RAW
URL: {{URL}}/api/v1/auth/register

Headers:

Body:

{
	"name" : "John Doe",
	"email":"[email protected]",
	"password":"123456",
	"role":"user"
	
}

2. Login

Route for user Login using email & password.

Endpoint:

Method: POST
Type: RAW
URL: {{URL}}/api/v1/auth/login

Headers:

Body:

{
	"email":"[email protected]",
	"password":"123456"
	
}

3. Get LoggedIn user

Get the details of a loggedIn user by sending the JWT token in header

Endpoint:

Method: GET
Type: RAW
URL: {{URL}}/api/v1/auth/me

Headers:

4. Forgot Password

Genrerate password token and send Email

Endpoint:

Method: POST
Type: RAW
URL: {{URL}}/api/v1/auth/forgotpassword

Body:

{
	"email":"[email protected]"
}

5. Reset Password

PUT request for reset password using reset-token

Endpoint:

Method: PUT
Type: RAW
URL: {{URL}}/api/v1/auth/resetpassword/9b787b3dfe09c93c4a4641869a585ad0e14621de

Headers:

Body:

{
	"password":"235689"
}

6. Update User

update user route for a loggedIn user

Endpoint:

Method: PUT
Type: RAW
URL: {{URL}}/api/v1/auth/updatedetails

Headers:

Body:

{
	"email":"[email protected]",
	"name":"Dipankar Barman"
}

7. Change Password

Change password route for frontEnd

Endpoint:

Method: PUT
Type: RAW
URL: {{URL}}/api/v1/auth/updatepassword

Headers:

Body:

{
	"currentPassword":"235689",
	"newPassword":"123456"
}

8. Logout user

Clear token from cookie

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/auth/logout

Users

CRUD operation for users,accessible only for ADMIN

1. Get Users

Get all the list of users saved in Database

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/users

Headers:

2. Get a single User

Get a single user by their ID

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/users/5c8a1d5b0190b214360dc038

3. Create a user

Create a user route

Endpoint:

Method: POST
Type: RAW
URL: {{URL}}/api/v1/users

Body:

{
	"name":"Aarushi Sharma",
	"email":"[email protected]",
	"password":"123456"
}

4. Update user

Update a user by their ID

Endpoint:

Method: PUT
Type: RAW
URL: {{URL}}/api/v1/users/5e908cb6f04d834cdcd86fc1

Body:

{
	"name":"Aarushi Sharma",
	"email":"[email protected]"
}

5. Delete User

Delete a user by their ID

Endpoint:

Method: DELETE
Type: RAW
URL: {{URL}}/api/v1/users/5e908cb6f04d834cdcd86fc1

Reviews

Manage reviews for bootcamps

1. Get reviews

Get all reviews route

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/reviews

2. Get reviews by Bootcamp

Get all reviews of a particular bootcamp

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/bootcamps/5d713a66ec8f2b88b8f830b8/reviews

3. Get Single reviews

Get a single review by their ID and populate bootcamp name and description

Endpoint:

Method: GET
Type: 
URL: {{URL}}/api/v1/reviews/5d7a514b5d2c12c7449be024

4. Add review

Add a review for a specific bootcamp by user or ADMIN

Endpoint:

Method: POST
Type: RAW
URL: {{URL}}/api/v1/bootcamps/5e90dab508121747f89df878/reviews

Headers:

Body:

{
		"title": "Testing another review!",
		"text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec viverra feugiat mauris id viverra. Duis luctus ex sed facilisis ultrices. Curabitur scelerisque bibendum ligula, quis condimentum libero fermentum in. Aenean erat erat, aliquam in purus a, rhoncus hendrerit tellus. Donec accumsan justo in felis consequat sollicitudin. Fusce luctus mattis nunc vitae maximus. Curabitur semper felis eu magna laoreet scelerisque",
		"rating": "5"
}

5. Update review

Update a particular review by their ID

Endpoint:

Method: PUT
Type: RAW
URL: {{URL}}/api/v1/reviews/5e90dafc08121747f89df87a

Headers:

Body:

{
	"title":"Updating the bootcamp"
}

6. Delete review

Delete a review route

Endpoint:

Method: DELETE
Type: 
URL: {{URL}}/api/v1/reviews/5e90dafc08121747f89df87a

Headers:

Back to top

Made with ♥ by thedevsaddam | Generated at: 2020-04-11 18:34:16 by docgen