A blog backend service with CRUD endpoints and database integration that runs locally on a Docker container. It can authenticate users and manage their blog posts on a database.

• GET, POST, PUT and DELETE endpoints
• Database integration
• MSC architecture
• Unit tests

Clone the project

  git clone https://github.com/Virkkunen/blog-api.git

Go to the project directory

  cd blog-api

Install dependencies

  npm i

Start the server

  docker-compose up -d

Migrate and seed the database

  npm run prestart
  npm run seed

Access the server terminal

  docker exec -it blogs_api bash

Start the service inside the container terminal

  npm run dev

The service is now running on localhost:3001

Endpoint will return a token used to login. User needs to add this token as an Authentication header on future requisitions.

  POST /login

Requisition body:

{ 
  "email": ${userEmail},
  "password": ${userPassword},
 }

  POST /user

Requisition body:

{ 
  "displayName": ${userName},
  "email": ${userEmail},
  "password": ${userPassword},
  "image": ${userImage}
 }

⚠️ User needs to be logged in

  GET /user

⚠️ User needs to be logged in

  GET /user/${userId}

⚠️ User needs to be logged in

  DELETE /user/me

⚠️ User needs to be logged in

  POST /categories

Requisition body:

{ "name": ${catName} }

⚠️ User needs to be logged in

  GET /categories

⚠️ User needs to be logged in

  POST /post

Requisition body:

{ 
  "title": ${postTitle}, 
  "content": ${postContent}, 
  "categoryIds": ${catIds}
}

⚠️ User needs to be logged in

  GET /post

⚠️ User needs to be logged in

  GET /post/${postId}

⚠️ User needs to be logged in

  PUT /post/${postId}

Requisition body:

{ 
  "title": ${postTitle}, 
  "content": ${postContent}
}

⚠️ User needs to be logged in

  DELETE /post/${postId}

⚠️ User needs to be logged in

Will return all posts with title and/or content matching the query

  GET /post/search?q=${query}

To run tests, run the following command

  npm run test

• @Virkkunen

Node.js, Express.js, MySQL, Sequelize, JWT, Docker, REST API, CRUD, MSC, Jest