Contacts-API

A contacts api built using django rest framework

Features

• Authentication: Implements token-based authentication to fortify the API against unauthorized access. Utilizing DRF's authentication classes, i ensure secure communication between clients and the API
• User Email OTP Verification: Implemented email verification using one-time passwords (OTPs). When users register their email addresses, a unique OTP is generated and sent to their email. Users can verify their email addresses by submitting the OTP they receive. This enhances account security and ensures valid email addresses.
• CRUD Operations: Leverages the power of Django Rest Framework to seamlessly perform Create, Read, Update, and Delete operations on contacts, groups and favourites.
• Paginated Response: leveraging the robust capabilities of Django Rest Framework's Pagination class to seamlessly deliver paginated responses for all endpoints returning multiple objects. By implementing pagination, users can efficiently retrieve a specified number of data per response, thereby minimizing query time and significantly boosting overall performance
• Alphabetical ordering for contact list results, enhancing user experience and making it easier to locate contacts by name
• Prioritizing Favourite Contacts: Users can mark certain contacts as favourites, allowing them to easily access and prioritize important information.
• Contact Grouping: Organizing contacts into groups or categories to streamline navigation and enhance organization.

Testing API

To test the functionality of the api, you can use the following login credentials to be authorized:

• email: steppaapitestuser@gmail.com
• password: testuser

Installation Guide

• Download or clone this repostory using

  git clone git@github.com:SteppaCodes/Contacts-API.git

• Navigate into your project directory

  cd contacts-api

• Create a virtual environment

  python -m venv env

• Activate the virtual environment
• On Windows:

  env\scripts\activate

• On Macos:

  source env/bin/activate

• Install dependencies

  pip install -r requirements.txt

• Run migrations to setup initial database schema

  python manage.py migrate

• Create super user(optional)

  python manage.py createsuperuser

• Run the development server

  python manage.py runserver

• Access the API: on your browser, navigate to

   http://127.0.0.1:8000/api/v1/
  

Authentication

Token-based authentication is used to secure the API endpoints. To access protected endpoints, include the token in the request headers:

Permissions

Permissions are implemented to control access to the API endpoints. By default, only authenticated users can access the endpoints. You can customize permissions according to your requirements.

Congratulations! You've successfully set up the Contacts API. If you encounter any issues or have any questions, feel free to reach out to me. Happy coding! 🚀