Skip to content

gclancy121/message-board-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

message-board-api

The entire API that my message board will use - users must be logged in to access any of the data, along with posting new data to the database.

This API is designed to be used with the matching frontend application. Find it here: https://github.com/gclancy121/message-board-frontend

How to Start: Go to the terminal and type "npm run start". The server will start without issue.

--- User Endpoints --- IMPORTANT: No user data is created by default - you must create your own with the correct information.

[GET] - /users: Get a list of all current users.

[GET] - /users/:username: Returns all information about a specific username.

[GET] - /users/byid/:id: Returns all information about a specific ID.

[PUT] - /users/:id: Allows a user to update their profile and returns the updated user profile.

[POST] - /users/reset-checks: Posts to make sure the information for a password reset is valid.

[POST] - /users/reset-password: Resets the user password. Passes through /reset-checks in the site.

[POST] - /users/register: Allows a user to add their credentials to a database, allowing them to log in and access the waifus. Payload must look like this: {username: "username", password: "password"}. Will throw error messages if any part of the payload is incorrect.

[POST] - /users/login: Allows a user to log in, responds with a token and a login message. Payload must look like this: {username: "username", password: "password"}. Will throw error messages if any part of the payload is incorrect.

[DELETE] - /users/:id: Allows a user to delete their own account. Responds with either a 1 or a 0 - 1 if successful, 0 if unsuccessful.

--- Waifu Endpoints --- [GET] - /waifus: Allows users to access all waifus.

[GET] - /waifus/:name: Fetch a waifu via a specific name. Name must be in params.

[GET] - /waifus/id/:id: Fetch a waifu via specific ID. ID must be in params.

[PUT] - /waifus/id/:id: Input information about a specific waifu via ID. ID must be in params.

[POST] - /waifus: Allows users to post a new waifu to the database. Payload must look like this: {waifu_name: "name", waifu_description: "description"}. Will throw error messages if any part of the payload is incorrect.

[DELETE] - /waifus/:id: Not currently implemented. Will allow users to delete a specific waifu at a specified ID.

--- Posts Endpoints --- [GET] - /posts: Allows users to access all posts.

[GET] - /posts/post-num/:id: Fetch the number of posts made by a specific user via ID.

[GET] - /posts/:post_id: Allows users to access a specific post using the post ID.

[POST] - /posts/addpost: Allows users to create a new post.

[GET] - /posts/get-creator/:id: Fetch the username of the creator of a specific post.

--- Comment Endpoints --- [GET] - /comments/:id - Fetches the comments on a post via the post_id.

[POST] - /comments/ - Posts a new comment on the post.

--- Complaints Endpoints --- [POST] - /complaints/ - Posts a new complaint to the database.

To give an example of how waifu data is stored, there are a few examples in /data/seeds/create_waifu_data. Use the generated information as a guide for how the rest of the waifus must look.

About

The API that my message board will consume.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published