Skip to content

rawidaniel/AfricEscape-RESTFUL-API

Repository files navigation

AfricEscape RESTFUL API

A RESTFUL API for booking tour sites


Introduction


AfricEscape is a RESTful API that provides details on numerous travel destinations. Also, It offers authentication and authorisation, users, reviews, and booking information all in json format. A tour booking website that enables users to explore a website, select their chosen location to visit, and make an online reservation can be built on top of this RESTFUL API.

Key features


  • Authentication and Authorization
    • Signup, Login and Logout
  • Tour
    • Creating, Getting, updating and Deleting tours
  • User
    • Creating, Getting, updating and Deleting users
  • Booking
    • Creating, Getting, updating and Deleting booking
  • Review
    • Creating, Getting, updating and Deleting reviews

How to install


  • clone this repository here

    git clone https://github.com/rawidaniel/AfricEscape-RESTFUL-API

  • Run npm install to install all dependencies

  • You can either work with the MongoDB Atlas or use your locally installed MongoDB. Do configure to your choice in the application entry file. you can watch youtube tutuorials from here

  • Create an config.env file in your project root folder and add your variables. See config.env.sample for assistance.

  • use npm run debug for debugging

Usage


  • Run npm start:dev to start the application for development and npm start:prod for production.

API Endpoints


You must configure the variables in Postman based on your environment(development or production) before using the API. Simply add:

- {{URL}} with your hostname as value (Eg. http://127.0.0.1:3000 or http://www.example.com)
- {{password}} with your user password as value.

Check out AfricEscape API Documentaion for more information.

API Features

Tours 👉 https://africescape-api.onrender.com/api/v1/tours

Users 👉 https://africescape-api.onrender.com/api/v1/users

Reviews 👉 https://africescape-api.onrender.com/api/v1/reviews

Bookings 👉 https://africescape-api.onrender.com/api/v1/bookings

Technologies Used


  • NodeJS This is a cross-platform runtime environment built on Chrome's V8 JavaScript engine used in running JavaScript codes on the server. It allows for installation and managing of dependencies and communication with databases.
  • ExpressJS This is a NodeJS web application framework.
  • MongoDB This is a free open source NOSQL document database with scalability and flexibility. Data are stored in flexible JSON-like documents.
  • Mongoose ODM This makes it easy to write MongoDB validation by providing a straight-forward, schema-based solution to model to application data.
  • MongoDB Atlas A cloud database service
  • Postman An API platform for building and using APIs

Authors


About

A RESTFUL API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •