REST API · JSON · v2.0
وب‌سرویس نمایندگان
سفارش‌های خود را به‌صورت خودکار از سایت یا نرم‌افزارتان ثبت کنید — کاملاً مطابق استاندارد پنل‌های SMM
💡
وب‌سرویس مخصوص نمایندگان
برای فعالسازی، از پروفایل درخواست نمایندگی بدهید.
99.9%
آپتایم
<2s
زمان پاسخ
5
endpointها
JSON
فرمت پاسخ
📡 اطلاعات پایه
🔗
آدرس پایه (Base URL):
https://tele4u.ir/api.php
📤
متدهای مجاز:
GET
POST
📦
فرمت پاسخ:
JSON
با Charset UTF-8
🔑
احراز هویت:
key=YOUR_API_KEY
به‌عنوان پارامتر query
⚙️ پارامترهای مشترک
پارامتر
الزامی
توضیح
action
✅ الزامی
نوع درخواست: add | status | services | balance | orders
📚 Endpointها
🚀
ثبت سفارش action=add
یک سفارش جدید ثبت کنید — مبلغ از کیف پول شما کسر میشود
service
✅ الزامی
شناسه سرویس (از action=services)
link
✅ الزامی
لینک پست/کانال/پیج
quantity
✅ الزامی
تعداد (بین حداقل و حداکثر سرویس)
text
🔘 اختیاری
فقط برای سرویس‌هایی که فیلد اضافه دارند (ایموجی/گزینه رأی)
✓ پاسخ موفق
HTTP 200
{
"order": 1024,
"track": "TF-A1B2C3",
"status": "Pending"
}
✕ پاسخ خطا
HTTP 200
{
"error": "موجودی کافی نیست."
}📊
استعلام وضعیت action=status
وضعیت یک سفارش مشخص را ببینید
order
✅ الزامی
شناسه سفارش دریافتی از ثبت
✓ پاسخ
{
"order": 1024,
"track": "TF-A1B2C3",
"status": "In progress",
"start_count": 500,
"remains": 200
}
مقادیر ممکن برای
status:
⏳ Pending
🔄 In progress
✅ Completed
⚠️ Partial
❌ Canceled
📋
لیست سرویس‌ها action=services
قیمت‌ها و محدودیت‌های همه سرویس‌ها (با تخفیف نمایندگی)
✓ پاسخ
array of services
{
"services": [
{
"id": 1,
"title": "بازدید پست تلگرام",
"rate": 0.45,
"min": 200,
"max": 100000
},
{
"id": 2,
"title": "ری‌اکشن پست تلگرام",
"rate": 20.00,
"min": 5,
"max": 10000
}
]
}
💡
rate قیمت هر ۱۰۰۰ عدد بعد از تخفیف نمایندگی شما است.
💰
استعلام موجودی action=balance
موجودی فعلی کیف پول شما
✓ پاسخ
{
"balance": 250000
}📦
لیست سفارش‌های شما action=orders
کلیه سفارش‌های شما قابل پیگیری — اعتماد بیشتر و شفافیت کامل
limit
🔘 اختیاری
تعداد سفارش‌ها (پیش‌فرض: 50، حداکثر: 200)
✓ پاسخ
array of orders
{
"orders": [
{
"id": 1024,
"track": "TF-A1B2C3",
"service": "بازدید پست تلگرام",
"link": "https://t.me/post/123",
"quantity": 1000,
"price": 450,
"status": "Completed",
"created_at": 1697520000
}
],
"total": 152
}
✨ این endpoint به شما امکان می‌دهد همه سفارش‌های ثبت‌شده از طریق API را به‌صورت یکجا پیگیری کنید — برای گزارش‌گیری و کنترل کامل.
💻 نمونه کد
🐘
PHP
file_get_contents
"hl-var">$res = file_get_contents("https://tele4u.ir/api.php?key=YOUR_KEY&action=add&service=1&link=https://t.me/post&quantity=1000");
"hl-var">$data = json_decode("hl-var">$res, "hl-kw">true);
"hl-kw">echo "hl-var">$data['order'] ?? "hl-var">$data['error'];
⚡
cURL
terminal
"hl-kw">curl "https://tele4u.ir/api.php?key=YOUR_KEY&action=balance"
📜
JavaScript
fetch
fetch('https://tele4u.ir/api.php?key=YOUR_KEY&action=balance')
.then(r => r.json())
.then(data => console.log(data));
🐍
Python
requests
import requests
r = requests.get('https://tele4u.ir/api.php', params={'key': 'YOUR_KEY', 'action': 'balance'})
print(r.json())⚠️ قواعد مهم
💳
کسر موجودی
هر سفارش از کیف پول شما کسر میشود — از افزایش موجودی شارژ کنید.
🛡️
خطا → بدون کسر
در صورت خطای وب‌سرویس، هیچ مبلغی از حساب شما کسر نمی‌شود.
🔒
کلید محرمانه
کلید API را در اختیار کسی نگذارید؛ در صورت افشا از پروفایل تعویض کنید.
📊
پیگیری کامل
کلیه سفارش‌های شما قابل پیگیری است — با
action=orders کل سفارش‌ها را ببینید.
🚀
آماید شروع کنید؟
همین حالا درخواست نمایندگی بدهید و کلید API اختصاصی خود را دریافت کنید
📨 درخواست فعالسازی نمایندگی