---
---
## 🧭 About the Project
> "Building the future, one line of code at a time."
**JWT Decoder API** is a lightweight and blazing-fast Flask application that allows you to **decode FreeFire JSON Web Tokens (JWT)** instantly — without needing a secret key.
Ideal for developers testing, debugging, or learning how JWT payloads work.
---
## ⚡ Features
| Emoji | Feature | Description |
| :---: | :------------------------ | :----------------------------------------------------- |
| 🧩 | **Decode JWTs Instantly** | Extract payload data from any token without validation |
| 🕒 | **Readable Time Format** | Converts UNIX timestamps to human-readable UTC time |
| 🧠 | **Expiration Check** | Detects expired tokens automatically |
| 🧰 | **REST API** | Simple `/decode_jwt` endpoint for programmatic use |
| 🌍 | **Cross-Platform** | Runs anywhere Flask and Python 3 are supported |
---
## 🧱 Tech Stack
---
## 🚀 Getting Started
### 📦 Installation
```bash
git clone https://github.com/TSun-FreeFire/TSun-FF-JwtDecode-Api.git
cd TSun-FF-JwtDecode-Api
```
### Install dependencies
```bash
pip install flask pyjwt
```
---
### ▶️ Usage
Run the Flask server:
```bash
python app.py
```
Then open your browser:
```bash
http://127.0.0.1:5000/decode_jwt?token=YOUR_JWT_TOKEN
```
Example Response:
```json
{
"sub": "1234567890",
"name": "John Doe",
"iat": "2025-11-02 14:23:00",
"exp": "2025-11-03 14:23:00",
"expired": false
}
```
---
## 🧑💻 API Reference
| Method | Endpoint | Parameter | Description |
| :----: | :------------ | :-------- | :---------------------- |
| GET | `/decode_jwt` | `token` | The JWT token to decode |
Example:
```
GET /decode_jwt?token=
```
---
## 🤝 Contributing
Contributions are welcome!
1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a pull request
---
## 🌐 Connect with Us
---
## 📊 GitHub Stats
---
## 🪪 License
This project is licensed under the [MIT License](LICENSE).
---