TSun Guest Account Generator API | Documentation & Explorer

Project Architecture & Overview

Welcome to the TSun Guest Account Generator API documentation. This application is a high-performance Flask-based solution designed to automate the creation of guest accounts, securely store results in Dropbox, and notify administrators via Telegram. This section visualizes the core components and the flow of data through the system.

Security

🔒

Protected via mandatory API_KEY validation for all incoming requests.

Storage

📦

Automated Dropbox uploads generating Direct Download Links instantly.

Notification

📢

Real-time Telegram alerts sent to Admin ID upon successful generation.

Technology Stack Distribution

A breakdown of the core Python libraries powering the API logic.

Data Flow Architecture

Visualizing the path from User Request to Final Notification.

👤

GET /guest

API

⬇

Generator Script

(Multi-threaded)

Dropbox

ZIP Upload

⬇

Success!

Link Generated

✈️

API Laboratory

Experiment with the API parameters in a safe simulation environment. This section allows you to construct requests, understand the parameter logic, and visualize the expected performance output based on the report's statistics.

Request Parameters

API Key (Required)

Region

Account Limit

Impacts generation time.

Name Prefix

Pass Prefix

Get API KEY

Generated Endpoint URL


                                http://127.0.0.1:5000/guest?key=saeedxdie...

Response

Click "Run Request" to generate accounts

Estimated Performance

Based on reported metrics: 2 accounts ≈ 10s

API Response Codes & Error Messages

Reference guide for all HTTP status codes and error messages returned by the API.

Success Responses (200)

HTTP 200 OK

Success: Accounts generated successfully.

file_name, download_link, accounts_requested, time_take

Client Errors (400)

HTTP 400

Error: "invalid limit" - Invalid limit parameter

Authentication Errors (403)

Invalid/Expired API Key

"This API is not available. Purchase a new one from the admin panel"

Limit Reached

"Account generation limit reached (X/Y). Upgrade to Premium..."

Server Errors (500)

Database Error: "Internal server error..."

Generation Failed: "generation failed..."

Dropbox Error: "Dropbox upload/link failed..."

🔑 API Pricing Plans

Choose the perfect plan for your account generation needs. Flexible options for developers and businesses.

AFFORDABLE

🥇

Gold Tier

Perfect for Testing & Small Projects

Custom

Set your account limit

Pay Per Usage

🎯 What's Included:

✓

Custom Account Limit

Choose how many accounts you need (1-1000+)

✓

Usage Tracking

Monitor your remaining quota in real-time

✓

Custom Expiration Date

Set when your API key expires

✓

Dropbox Integration

Direct download links for generated accounts

✓

Region Selection

Choose account region (PK, BD, IN, etc.)

⊗

Unlimited Accounts

Available in Premium tier

👍 BEST FOR:

Developers testing the API, small projects, or one-time account generation needs.

⭐ RECOMMENDED

👑

Premium Tier

For Power Users & Businesses

∞ Unlimited

No account limits whatsoever

Fixed Price

🚀 Everything in Gold PLUS:

✓

🌟 Unlimited Accounts

Generate as many accounts as you need

✓

⚡ No Usage Tracking

No quotas, no limits, total freedom

✓

🔒 Never Expires

Lifetime access or custom expiration

✓

⚙️ Priority Support

Faster response times for issues

✓

📊 Advanced Analytics

Detailed usage statistics and insights

✓

💎 All Future Features

Get new features as they're released

🎯 BEST FOR:

Businesses, resellers, automation services, and high-volume account generation.

📊 Quick Comparison

Feature	🥇 Gold	👑 Premium
Account Limit	Custom (1-1000+)	∞ Unlimited
Usage Tracking	✅ Yes	❌ No (Unlimited)
Expiration	Custom Date	Never / Custom
Dropbox Integration	✅	✅
Region Selection	✅	✅
Priority Support	❌	✅
Future Features	Standard	All Access

Ready to Get Started? 🚀

Contact us on Telegram to purchase your API key. We'll set you up within minutes!

Purchase on Telegram

💬 Fast response • 🔐 Secure payment • ✅ Instant activation

❓ Frequently Asked Questions

How do I purchase an API key? ▼

Contact @saeedxdie on Telegram. Provide your desired tier (Gold/Premium) and account limit (for Gold). You'll receive your API key within minutes after payment.

Can I upgrade from Gold to Premium later? ▼

Yes! Contact us on Telegram to upgrade your existing API key from Gold to Premium tier at any time.

What payment methods do you accept? ▼

We accept various payment methods. Contact us on Telegram to discuss payment options available in your region.

Is there a refund policy? ▼

Refund policies are discussed on a case-by-case basis. Contact us if you have concerns about your purchase.

Setup & Configuration

Follow this interactive guide to deploy the API locally or on Vercel. Ensuring the environment variables are correctly set is critical for the integration with Dropbox and Telegram.

🔑 Environment Variables (`.env`)

Variable	Required	Description
API_KEY	Yes	Security key for endpoint access.
DROPBOX_ACCESS_TOKEN	Yes	Must have `files.content.write` scope.
TELEGRAM_BOT_TOKEN	Optional	From BotFather.
TELEGRAM_ADMIN_ID	Optional	Numeric User ID.

💻 Terminal Commands

1. Clone Repo

git clone src coming soon...
cd soon

2. Install Dependencies

pip install -r requirements.txt

3. Run API

python api.py

Troubleshooting

Common issues related to Telegram notifications and Dropbox authentication.

Telegram Notification Missing? ▼

Check ENV vars: TELEGRAM_BOT_TOKEN & TELEGRAM_ADMIN_ID.
Critical: You must send the /start command to your bot first.

Dropbox Link Error? ▼

Ensure Token Scopes: files.content.write, files.content.read, sharing.write.
Regenerate token after changing permissions.

Changelog History

2025-12-01

[FEAT]

Added Telegram Notification integration.

[FEAT]

Switched from Google Drive to Dropbox.

2025-12-01

[FIX]

Robust link cleaning for ?dl=1.

2025-12-01

[CHG]

Updated API response keys.

🚀 Navigation

Project Architecture & Overview

Security

Storage

Notification

Technology Stack Distribution

Data Flow Architecture

API Laboratory

Request Parameters

Response

Error

Estimated Performance

API Response Codes & Error Messages

Success Responses (200)

Client Errors (400)

Authentication Errors (403)

Server Errors (500)

🔑 API Pricing Plans

Gold Tier

🎯 What's Included:

Premium Tier

🚀 Everything in Gold PLUS:

📊 Quick Comparison

Ready to Get Started? 🚀

❓ Frequently Asked Questions

Setup & Configuration

🔑 Environment Variables (`.env`)

💻 Terminal Commands

1. Clone Repo

2. Install Dependencies

3. Run API

Troubleshooting

Changelog History

2025-12-01

2025-12-01

2025-12-01