API Documentation

USER

Get current User

• Require Authentication:

• Request

  • Method: GET

  • URL:

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Log in a User

• Require Authentication:

• Request

  • Method: POST

  • URL:

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Sign in a User

• Require Authentication:

• Request

  • Method: POST

  • URL:

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Update user

• Require Authentication:

• Request

  • Method: PUT

  • URL:

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Delete user

• Require Authentication:

• Request

  • Method: DELETE

  • URL:

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

STORY

Get all stories

• Require Authentication:

• Request

  • Method: GET

  • URL: /api/stories/all

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Get all stories by current user

• Require Authentication:

• Request

  • Method: GET

  • URL: /api/stories/:username

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Get all stories by authors the user is following

• Require Authentication:

• Request

  • Method: GET

  • URL: /api/stories/:userId/following

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Get all stories by tag

• Require Authentication:

• Request

  • Method: GET

  • URL: /api/stories/:tag

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Get story by id

• Require Authentication:

• Request

  • Method: GET

  • URL: /api/stories/:storyId

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Get top 6 stories by number of claps

• Require Authentication:

• Request

  • Method: GET

  • URL: /api/stories/trending

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Create a new story

• Require Authentication:

• Request

  • Method: POST

  • URL: /api/stories/new

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Update story by story id

• Require Authentication:

• Request

  • Method: PUT

  • URL: /api/stories/:storyId

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Delete story

• Require Authentication:

• Request

  • Method: DELETE

  • URL: /api/stories/:storyId

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

RESPONSES

Get all responses by story id

• Require Authentication:

• Request

  • Method: GET

  • URL: /api/responses/:storyId

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Get all responses by user id

• Require Authentication:

• Request

  • Method: GET

  • URL: /api/responses/:userId

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Create a response by story id

• Require Authentication:

• Request

  • Method: POST

  • URL: /api/responses/:storyId

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Update a response by response id

• Require Authentication:

• Request

  • Method: PUT

  • URL: /api/responses/:responseId

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Delete response

• Require Authentication:

• Request

  • Method: DELETE

  • URL: /api/responses/:storyId

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Follows

Add new follows by user id

• Require Authentication:

• Request

  • Method: POST

  • URL: /api/:userId/following

  • Headers:

    • Content-Type: application/json

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Update follows by user id

• Require Authentication:

• Request

  • Method: PUT

  • URL: /api/:userId/following

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Claps

Add claps by story id and user id

• Require Authentication:

• Request

  • Method: POST

  • URL: /api/claps/:storyId

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Add claps by response id and user id

• Require Authentication:

• Request

  • Method: POST

  • URL: /api/claps/:responseId

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Delete claps by story id and user id

• Require Authentication:

• Request

  • Method: PUT

  • URL: /api/claps/:storyId

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body:

Delete claps by response id and user id

• Require Authentication:

• Request

  • Method: PUT

  • URL: /api/claps/:userId

  • Body:

• Successful Response

  • Status Code:

  • Headers:

    • Content-Type: application/json

  • Body: