Dae-Alright-Backend

Technologies Used

• NodeJS
• ExpressJS
• PostgreSQL

Getting Started

Prerequisites

Ensure you have the following installed on your local machine:

• NodeJS
• PostgreSQL

Installing/Run locally

• Make sure you have nodejs, postgres installed.

• Clone or fork repo🤷‍♂

    - git clone https://github.com/devcareer/Dae-Alright-Backend
    - cd Dae-Alright-Backend
    - npm install

• Create a PostgreSQL database by running the command below in psql

    createdb -h localhost -p 5432 -U postgres dae_dev

• Create/configure .env environment with your credentials. A sample .env.example file has been provided to get you started. Make a duplicate of .env.example and rename to .env, then configure your credentials.

• Run npm run dev to start the server and watch for changes.

Testing

Test specs are implemented using mocha & chai.

• To test or consume the API locally, you can make use of Postman to simulate a front-end client.

If you want to take the step below, first create a PostgreSQL database by running the command below in psql.

 createdb -h localhost -p 5432 -U postgres dae_test

• There is also a test script that you can fire up by running npm test. npm test performs a single full test suite run, including code coverage reporting.

HTTP Requests

All API requests are made by sending a secure HTTPS request using one of the following methods, depending on the action being taken:

• POST Create a resource
• GET Get a resource or list of resources
• PATCH Update a resource
• DELETE Delete a resource

For POST and PATCH requests, the body of your request may include a JSON payload.

HTTP Response Codes

Each response will be returned with one of the following HTTP status codes:

• 200 OK The request was successful
• 400 Bad Request There was a problem with the request (security, malformed)
• 401 Unauthorized The supplied API credentials are invalid
• 403 Forbidden The credentials provided do not have permissions to access the requested resource
• 404 Not Found An attempt was made to access a resource that does not exist in the API
• 500 Server Error An error on the server occurred