Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Hamdan-Khan authored Nov 18, 2024
1 parent 2e80751 commit 6cd4487
Showing 1 changed file with 98 additions and 14 deletions.
112 changes: 98 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,115 @@
# API Playground
# 👋 Introducing `API Playground`

API Playground is a utility tool built with React.js that allows you to make HTTP requests and interact with APIs. It provides a user-friendly interface to modify the request's body, query parameters, headers, and authentication options, and displays the corresponding response.
API Playground is a utility tool built with React.js that allows you to make HTTP requests and interact with APIs. It provides a user-friendly interface to modify request parameters, send different types of HTTP requests, and view responses.

[Link to API Playground](https://apis-playground.vercel.app/)
<p align="center">
<img src="https://res.cloudinary.com/dftm1aoqy/image/upload/v1687354423/api-playground_vogmtc.png" alt="API Playground Interface"/>
</p>

# 🚀 Demo
Check out the live demo of API Playground:

![Alt Text](https://res.cloudinary.com/dftm1aoqy/image/upload/v1687354423/api-playground_vogmtc.png)
> [API Playground](https://apis-playground.vercel.app/)
## Features
Liked it? Please give a ⭐️ to **API Playground**.

- Make (GET/POST/DELETE/PUT/PATCH) HTTP requests to APIs and display the reponse in JSON format
# 💻 Use API Playground
Access the project directly:

![Response in JSON](https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355161/api-playground-response_flf9lv.png)
> https://github.com/yourusername/api-playground
# 🔥 Features

## 🌐 HTTP Request Support
- Make requests using GET, POST, DELETE, PUT, and PATCH methods
- Display responses in JSON format

<p align="center">
<img src="https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355161/api-playground-response_flf9lv.png" alt="JSON Response"/>
</p>

## 🛠️ Request Customization
- Customize request body and query parameters

![Request Body](https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355160/api-playground-body_yqlb0h.png)
<p align="center">
<img src="https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355160/api-playground-body_yqlb0h.png" alt="Request Body"/>
<img src="https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355160/api-playground-query_bk8jaw.png" alt="Query Parameters"/>
</p>

## 📡 Authentication Options
- Set custom headers
- Support for Basic Authentication and Bearer Token

<p align="center">
<img src="https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355160/api-playground-headers_etgoua.png" alt="Request Headers"/>
<img src="https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355160/api-playground-auth_fxa3ex.png" alt="Authentication"/>
</p>

## 📡 Authentication Options
- Basic Authentication
- Bearer Token support

# 🏗️ How to Set up `API Playground` for Development?

1. Clone the repository

```bash
git clone https://github.com/yourusername/api-playground.git
```

2. Change the working directory

```bash
cd api-playground
```

3. Install dependencies

```bash
npm install
```

4. Run the app

```bash
npm start
```

# 🍔 Built With
- [React.js](https://reactjs.org/)
- [Axios](https://axios-http.com/)
- [React Router](https://reactrouter.com/)

# 🛡️ License
This project is licensed under the MIT License - see the [`LICENSE`](LICENSE) file for details.

# 🦄 Upcoming Features
- Add support for more authentication methods
- Implement request/response history
- Add environment variable support
- Improve error handling
- Create saved request collections

If you find something is missing, `API Playground` is listening. Please create a feature request [from here](https://github.com/yourusername/api-playground/issues/new).

![Request Query parameters](https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355160/api-playground-query_bk8jaw.png)
# 🤝 Contributing to `API Playground`
Any kind of positive contribution is welcome! Please help us to grow by contributing to the project.

- Set the headers and send Basic Authentication or Bearer Token
If you wish to contribute, you can work on any features [listed here](#-upcoming-features) or create one on your own. After adding your code, please send us a Pull Request.

![Request Headers](https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355160/api-playground-headers_etgoua.png)
> Please read [`CONTRIBUTING`](CONTRIBUTING.md) for details on our [`CODE OF CONDUCT`](CODE_OF_CONDUCT.md), and the process for submitting pull requests.
![Basic Authentication or Bearer Token](https://res.cloudinary.com/dftm1aoqy/image/upload/v1687355160/api-playground-auth_fxa3ex.png)
# 🚀 Deploy

<a href="https://vercel.com/new/project?template=https://github.com/yourusername/api-playground">
<img src="https://vercel.com/button" height="37.5px" />
</a>
<a href="https://app.netlify.com/start/deploy?repository=https://github.com/yourusername/api-playground">
<img src="https://www.netlify.com/img/deploy/button.svg" height="37.5px" />
</a>

## Contributions
---

Contributions are welcome! If you encounter any issues or have suggestions for improvements, please create a new issue or submit a pull request.
<h3 align="center">
A ⭐️ to <b>API Playground</b> is appreciated as a motivation booster.
</h3>

0 comments on commit 6cd4487

Please sign in to comment.