Skip to content

The objective of this project is to provide an effective solution for task management and can be easily integrated with other applications.

License

Notifications You must be signed in to change notification settings

GScripter/lembrar-me_api

Repository files navigation

⭐ LEMBRAR-ME API

⭐ This is the README file for the LEMBRAR-ME API. It provides information about the API, how to use it, and how to contribute to the project.

-----------------------------------------------------

🧩 Introduction    |    🚀 Endpoints   |    🧪 Dependencies   |    💡 Contribute   |    🏆 Credits       


🧩 Introduction

⭐ This project consists of a To-Do List API, which has been given the identifying name LEMBRAR-ME, that allows users to efficiently and organizedly manage their tasks. The API was developed using modern and scalable technologies such as Python, Django and Postgresql, and follows good development practices to ensure code quality and security. With the LEMBRAR-ME API, users will be able to create, update, and delete tasks. Additionally, the API has an excellent search feature so that users can easily find the tasks they want to perform. The objective of this project is to provide an effective solution for task management and can be easily integrated with other applications.

🚀 Endpoints

URL: https://lembrar-me-api.up.railway.app >>> All results were successfully achieved. In general, these are the results of each request.

⭐ Method ⭐ Endpoint ⭐ Explanation
GET /annotations/ Get all annotations
GET /annotations/search/?q={query} Search annotation
GET /annotations/{id}/ Get 1 annotation
POST /api/token/ Obtain access token
POST /api/token/refresh/ Update access token
POST /api/register/ Register user
POST /subscribe/ Subscribe
POST /contact/ Get in touch
POST /create/annotation/ Create annotation
PUT /api/update/password/ Change user password
PUT /annotations/update/{id}/ Update annotation
DELETE /api/delete/account/ Delete user account
DELETE /delete/annotation/{id}/ Delete annotation

🧪 Dependencies

Requirements to rotate the code.

  • Docker
  • docker-compose
  • git

Step-1

git clone link https://github.com/GScripter/lembrar-me_api/

Step-2

Change the values of environment variables in the docker-compose.yml.

Key Value
DEBUG True/False
SECRET_KEY Application secret key
EMAIL_HOST_USER Your Gmail
EMAIL_HOST_PASSWORD Gmail app password
CLOUD_NAME Your name in Cloudinary
API_KEY Your API key on Cloudinary
API_SECRET Your API secret on Cloudinary

Step-3

After placing the values of the environment variables, just run the command: docker-compose up and the application will be available on port 8000.

OBS: It is also possible to run the application without docker, just clone the repository, create an .env file in the root of the project with the necessary keys and values and install the project dependencies in requirements.txt, however the use of docker is encouraged, for a construction with no chance of failure.

💡 How to contribute

If you would like to contribute to this project, please follow the steps below:

1- Create a fork of this repository by clicking the "Fork" button in the top right corner of the page.

2- Clone your fork to your local machine: git clone https://github.com/your_username/repository_name.git

3- Create a branch for your changes: git checkout -b my_feature_branch

4- Make desired changes to the code and add your files using the git add . command.

5- Ensure your code passes all tests.

6- Commit your changes with a clear message of what was done: git commit -m "Added new feature"

7- Push to the branch you created on your fork: git push origin my_feature_branch

8- Open a pull request to this repository by clicking the "New Pull Request" button on your fork's repository page.

9- Wait for the project reviewer to evaluate your code.

Thank you for your contribution!


License

This project is licensed under the MIT. See the LICENSE file for more information.


🏆 Credits

⭐ For every project we have to give credits to the creators so nothing better than finishing with a golden key with the creators / creator of the project.



Gabriel Santana
Hello 😃 If you made it this far, I believe you liked my project, in which case we have something in common, so how about we talk a little? My call on linkedin 😁

About

The objective of this project is to provide an effective solution for task management and can be easily integrated with other applications.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published