🍸 Cocktail Recipes API

📌 Overview

The Cocktail Recipes API is a RESTful API that allows users to explore, create, update, and delete cocktail recipes.

🚀 Features

📖 Retrieve a list of all cocktails or a specific recipe.

➕ Create a new cocktail recipe.

✏️ Update existing cocktail recipes.

❌ Delete a recipe from the database.

🔍 Search for cocktails by name or ingredients.

🛠️ Tech Stack

Backend: Node.js, Express.js

Tools: Postman

📂 Endpoints

🔍 Get All Cocktails

GET /cocktails

Response:

[
  {
    "id": 1,
    "name": "Mojito",
    "ingredients": ["White Rum", "Sugar", "Lime", "Soda Water", "Mint"],
    "instructions": "Muddle mint leaves with sugar and lime juice, add rum, and top with soda water."
  }
]

🔍 Get a Specific Cocktail

GET /cocktails/:id

Response:

{
  "id": 1,
  "name": "Mojito",
  "ingredients": ["White Rum", "Sugar", "Lime", "Soda Water", "Mint"],
  "instructions": "Muddle mint leaves with sugar and lime juice, add rum, and top with soda water."
}

🔍 Filter Cocktails

GET /api/cocktails/filter?key={attribute}&value={value}

Example Request:

GET /api/cocktails/filter?key=ingredients&value=Vodka

Response:

[
  {
    "id": 2,
    "name": "Espresso Martini",
    "category": "Cocktail",
    "ingredients": ["Vodka", "Coffee Liqueur", "Espresso", "Sugar Syrup"],
    "instructions": "Shake all ingredients with ice and strain into a martini glass."
  }
]

➕ Add a New Cocktail

POST /cocktails

Request Body:

{
  "name": "Margarita",
  "ingredients": ["Tequila", "Triple Sec", "Lime Juice", "Salt"],
  "instructions": "Shake all ingredients with ice and strain into a salt-rimmed glass."
}

✏️ Update a Cocktail

PUT /cocktails/:id

Request Body:

{
  "name": "Updated Margarita",
  "ingredients": ["Tequila", "Triple Sec", "Lime Juice", "Salt"],
  "instructions": "Blend with ice for a frozen margarita."
}

❌ Delete a Cocktail

DELETE /cocktails/:id

Response:

{
  "message": "Cocktail deleted successfully."
}

🔧 Installation & Usage

1️⃣ Clone the Repository

git clone https://github.com/your-username/cocktail-recipes-api.git
cd cocktail-recipes-api

2️⃣ Install Dependencies

npm install

3️⃣ Run the Server

npm start

The API will be available at http://localhost:3000.

📌 Future Improvements

🍸 Create a front-end to display the cocktails

📂 Add recipes to a database for better storage and scalability

✅ Authentication & authorization

📦 Migrate from JSON storage to a database (MongoDB, PostgreSQL, etc.)

🌍 Deploy the API for public access

👨‍💻 Contributing

Feel free to fork, create issues, and submit pull requests to improve the project!