Readme.md

---

---

🧭 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

git clone https://github.com/TSun-FreeFire/TSun-FF-JwtDecode-Api.git
cd TSun-FF-JwtDecode-Api

Install dependencies

pip install flask pyjwt

---

▶️ Usage

Run the Flask server:

python app.py

Then open your browser:

http://127.0.0.1:5000/decode_jwt?token=YOUR_JWT_TOKEN

Example Response:

{
  "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=<your_token_here>

---

🤝 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.

---