MARKETPRO DEVELOPER APIجهت جلوگیری از سوءاستفادههای سایبری، دریافت وبسرویس مستلزم تکمیل سطح ۱ (تأیید همراه)،سطح ۲ (احراز هویت فردی و کارت) و سپس سطح ۳ (ارسال قرارداد امضاشده + ویدیوی ۱۲ کلمهای) و تأیید نهایی توسط مدیریت مارکتپرو میباشد.
کلیه سفارشهای وبسرویس با مسئولیت کامل دارنده کلید API ثبت میگردد. پذیرنده موظف است احراز هویت کاربران نهایی خود را برای مقابله با فیشینگ و کارتهای سرقتی مدیریت نماید.
حداقل مبلغ هر تراکنش شارژ حساب وبسرویس مبلغ ۵۰۰,۰۰۰ تومان (معادل ۵,۰۰۰,۰۰۰ ریال) است. این موجودی صرفاً جهت کسر خودکار هزینه سفارشهای موفق وبسرویس تخصیص مییابد.
کلیه قیمتها در تمام متدهای وبسرویس (کاتالوگ /products، پیشفاکتور /quote و سفارش /orders) به صورت لحظهای و مستقیم بر اساس نرخ زنده ارز و تأمین رسمی تلگرام محاسبه میگردند و سفارشها همیشه با بهترین نرخ بازار تسویه میشوند.
نمونه کدهای آماده اتصال برای رباتهای تلگرام
نمونه کامل و تستشده به زبانهای پایتون، نودجیاس، پیاچپی و کرل
import requests
API_KEY = "mk_live_your_actual_api_key_here"
BASE_URL = "https://marketpro.one/api/v1/bot"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
# ۱. استعلام موجودی ریالی کیف پول
def check_balance():
response = requests.get(f"{BASE_URL}/balance", headers=headers)
data = response.json()
if data.get("ok"):
print(f"موجودی کیف پول: {data['wallet']['formattedToman']} تومان")
return data["wallet"]["balanceToman"]
else:
print("خطا در استعلام موجودی:", data.get("error"))
# ۲. ثبت سفارش تلگرام پرمیوم ۳ ماهه
def buy_telegram_premium(username: str):
payload = {
"slug": "telegram-premium-3m",
"quantity": 1,
"recipientUsername": username.replace("@", ""),
"externalOrderId": "BOT-ORDER-1001"
}
response = requests.post(f"{BASE_URL}/orders", json=payload, headers=headers)
res = response.json()
if response.status_code == 201 and res.get("ok"):
print(f"سفارش ثبت شد! کد رهگیری: {res['order']['code']}")
print(f"موجودی باقیمانده: {res['order']['remainingBalanceToman']} تومان")
return res["order"]
elif response.status_code == 402:
print("کسری موجودی! حداقل مبلغ شارژ ۵۰۰,۰۰۰ تومان است.")
else:
print("خطا در ثبت سفارش:", res.get("error"))
# ۳. پیگیری سفارش
def check_order_status(order_code: str):
response = requests.get(f"{BASE_URL}/orders/{order_code}", headers=headers)
return response.json()
if __name__ == "__main__":
check_balance()
# buy_telegram_premium("durov")
فهرست آدرسهای وبسرویس (API Endpoints)
/api/v1/bot/balanceمشاهده موجودی ریالی و تومانی حساب کاربری جهت اطمینان از کفایت اعتبار.
/api/v1/bot/productsدریافت لیست محصولات فعال (پرمیوم ۳، ۶ و ۱۲ ماهه، استارز، گیفتها) به همراه قیمت زنده.
/api/v1/bot/quoteارسال slug و quantity جهت دریافت مبلغ دقیق به تومان و ریال قبل از نهاییسازی سفارش.
/api/v1/bot/ordersکسر آنی از کیف پول ریالی و تحویل فوری اکانت پرمیوم یا استارز به یوزرنیم اعلامشده.
/api/v1/bot/orders/:codeاستعلام آخرین وضعیت پردازش سفارش در شبکه تلگرام با کد رهگیری یا externalOrderId.
جدول خطاهای استاندارد وبسرویس
| کد وضعیت | عنوان خطا | شرح و راهکار رفع خطا |
|---|---|---|
| 200 / 201 | عملیات موفق | درخواست با موفقیت اجرا شد و سفارش در صف تحویل قرار گرفت. |
| 400 Bad Request | ورودی نامعتبر | تعداد کمتر/بیشتر از حد مجاز یا فرمت یوزرنیم تلگرام اشتباه است. |
| 401 Unauthorized | کلید نامعتبر | هدر Authorization با کلید صحیح ارسال نشده است. |
| 402 Payment Required | کسری موجودی ریالی | موجودی حساب وبسرویس کافی نیست. حداقل شارژ حساب ۵۰۰,۰۰۰ تومان است. |
| 403 Forbidden | عدم احراز هویت | مدارک احراز هویت وبسرویس (سطح ۳) هنوز تأیید نشده است. |