For this project, you are provided a starting code for a back end JSON API and are to build on this starting code by adding new features. The starting code is for the application described in the section below, and you can find your assigned work on the Issues tab of this repository. Please open a single pull request with all of the changes needed to implement the features described in the issue, then return to the Hatchways dashboard to mark your assessment as completed.
We will use this rubric to evaluate your submission. Please note that if your submission does not attempt to complete all of the requirements, or does not pass our plagiarism screening, we will be unable to provide feedback on it. Please contact hello@hatchways.io if you have any questions or concerns.
You will be modifying an existing server that provides an API for a blogging website. The database for the API has a table of blog Posts, which include information about each blog post such as the text and author of the post, how many times the post has been “liked”, etc. Additionally, the database contains Users. Each blog post can have multiple authors, which correspond to users in the database (this association is stored in the database as UserPost). A new blog post must have at least one author that is a user already registered in the database.
Currently, the starting code has the following API routes already implemented:
- POST
/api/register- Register a new user - POST
/api/login- Login for an existing user - POST
/api/posts- Create a new post
Only a logged in User can use this blogging website API, with the exception of the login and register routes.
The current recommended Node.js version is 16
Create a .env file in the root directory, and copy the contents from .env.sample
yarn
yarn lint
Please format your code before making a pull request to make it easier for us to review the code.
yarn prettier
yarn dev
Your repository contains a non-comprehensive set of unit tests used to determine if your pull request has met the basic requirements of the task given to you. These tests should NOT be modified unless specified in your GitHub issue.
To run these tests, use the following command:
yarn test
Note: No database setup should be required to get started with running the project.
This project uses SQLite, which stores your tables inside a file. It uses Sequelize (v6) as an ORM layer.
We've included sample data that the application has been configured to use. If you want to re-seed the database, you can run yarn seed. seed.js can be referenced to see what the sample data is. Viewing the database file itself is not required to complete your tasks, but if you would like to, an application like DB Browser for SQLite can be used.
You can use cURL or a tool like Postman to test the API.
You can log in as one of the seeded users with the following curl command:
curl --location --request POST 'localhost:8080/api/login' \
--header 'Content-Type: application/json' \
--data-raw '{
"username": "thomas",
"password": "123456"
}'Then you can use the token that comes back from the /login request to make an authenticated request to create a new blog post
curl --location --request POST 'localhost:8080/api/posts' \
--header 'x-access-token: your-token-here' \
--header 'Content-Type: application/json' \
--data-raw '{
"text": "This is some text for the blog post...",
"tags": ["travel", "hotel"]
}'If you encounter an error related to secretOrPrivateKey when attempting to make a request, please ensure you have created a .env file in the root directory as per the Server instructions.