⭐ 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
⭐ 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.
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 |
Requirements to rotate the code.
- Docker
- docker-compose
- git
git clone link https://github.com/GScripter/lembrar-me_api/
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 |
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.
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!
This project is licensed under the MIT. See the LICENSE file for more information.
⭐ 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 😁 |
---|