Skip to content

๐Ÿธ ๐Ÿน๐Ÿฅ‚๐Ÿท๐Ÿธ๐Ÿพ๐ŸนThis API contains a collection of free, open source cocktail data. This project was created for entry level developers who need access to free API's.

Notifications You must be signed in to change notification settings

carlagesa/CocktailDB

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

38 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿธ ๐Ÿน๐Ÿฅ‚๐Ÿท๐Ÿธ๐Ÿพ๐ŸนCocktailDB

This API contains a collection of free, open source cocktail data. This project was created for entry level developers who need access to free API's. The API is built using Django Rest framework.

๐Ÿš€ Exciting Upcoming Features

We're constantly evolving CocktailDB to better serve our developer community. Here's a sneak peek at some of the awesome features we're currently working on:

๐ŸŽฏ 1. Enhanced API Rate Limiting

  • Protect your usage: Sophisticated rate limiting to ensure fair use and protect against abuse.
  • Custom limits: Personalized limits based on usage tiers.

โšก 2. Blazing Fast Caching

  • Speed up your requests: Caching frequently requested data to drastically reduce response times.
  • Seamless experience: Enjoy faster and more efficient data retrieval.

๐Ÿ” 3. Secure User Authentication

  • Keep it personal: Implementing token-based authentication for secure and personalized API access.
  • Your data, your rules: Control who can access your API data.

๐Ÿ” 4. Advanced Search Capabilities

  • Powerful search: Introducing multi-ingredient filtering and complex queries.
  • Find exactly what you need: More flexibility and precision in search results.

๐Ÿฅ‚ 5. Discover Popular & Latest Cocktails

  • Stay trendy: New endpoints to showcase the most popular cocktails.
  • What's new? Easily discover the latest additions to the cocktail database.

๐Ÿ“ธ 6. High-Quality Ingredient Images

  • Visual delight: Adding ingredient images in various resolutions (small, medium, large) to enhance API data.
  • More than just text: Elevate your application with stunning visual elements.

โœจ Stay tuned for these features and more as we continue to make CocktailDB the best API for developers!

Screenshots

Success!

API Reference

The API reference is also accessible from the API link . This is made possible by the implementation of a preetry cool platform called Swagger.

Swagger is an Open Source set of rules, specifications and tools for developing and describing RESTful APIs. The Swagger framework allows developers to create interactive, machine and human-readable API documentation.

Deployment

The project is currently deployed on Vercel and uses PostgreSQL.

Run Locally

Clone the project

  git clone https://github.com/carlagesa/CocktailDB.git

Go to the project directory

  cd CocktailDB

Create you virtual environment & activate it.

  py -m venv myenv
  myenv\Scripts\activate.bat

Install from requirements.txt file

  pip freeze -r requirements.txt

Run migrations & start server

  python manage.py makemigrations
  python manage.py migrate
  python manage.py runserver

CocktailDB๐Ÿน Web Scrapper

For the data to populate the DB check my other repository built specicically for this project. It scrapes the internet for cocktail data and arranges the data into an excel sheet which later can be imported into the DB using one command.For more info on this, checkout the Cocktail Scrapper.
Although to save on time I took the initiative to place the already populated excel sheet inside the data folder. Quickly run๐Ÿ‘‡๐Ÿพ

  python manage.py import_cocktails

Successfully imported cocktail data

Success!

Tech Stack

Server: Python, Django, PostgreSQL, Swagger API Doc

Authors

For project opportunities kindly check github profile for social links๐Ÿ˜Š

About

๐Ÿธ ๐Ÿน๐Ÿฅ‚๐Ÿท๐Ÿธ๐Ÿพ๐ŸนThis API contains a collection of free, open source cocktail data. This project was created for entry level developers who need access to free API's.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published