برای توسعه‌دهندگان و فروشندگان

API پرمیوم تلگرام

از ربات، فروشگاه یا پلتفرم خود با یک فراخوانی REST به هر نام کاربری پرمیوم هدیه دهید.

API پرمیوم تلگرام تی جی تولز یک اندپوینت REST برای هدیه‌دادن برنامه‌نویسی‌شده پرمیوم است. درخواست POST /api/purchase/premium را با نام کاربری گیرنده و پلن ۳، ۶ یا ۱۲ ماهه بفرستید، با هدر X-Api-Key احراز هویت کنید و اشتراک ظرف چند ثانیه از طریق Fragment.com فعال می‌شود. پیش از سفارش، GET /api/purchase/user/{username} وجود حساب و واجد شرایط بودن آن برای پرمیوم را تأیید می‌کند و GET /api/purchase/prices قیمت لحظه‌ای پلن‌ها را به تون برمی‌گرداند — هر دو بدون احراز هویت. کلید API را خودتان در داشبورد وب می‌سازید، تا ۵ کلید فعال، بدون فرم درخواست و بدون تماس فروش. اشتراک و کارمزد به‌ازای هر درخواست وجود ندارد: سفارش‌ها از موجودی کیف پول تی جی تولز پرداخت می‌شوند، هر پاسخ JSON قابل پیش‌بینی است و هر کلید لاگ فراخوانی مخصوص خودش را در داشبورد دارد.

پیش‌نمایش اندپوینت‌های API

کلید API رایگان · بدون KYC
مستندات کامل API →

نیازی به احراز هویت نیست — ثبت‌نام کنید، کلید API بسازید و در چند دقیقه سفارش بفرستید.

دسترسی API رایگان است. فقط هزینه استارز، پرمیوم یا NFT از موجودی کیف پول تون شما کسر می‌شود.

احراز هویت: X-Api-Key: tgt_… یا Authorization: Bearer tgt_…

آدرس پایه: https://api.tg-tools.shop

استارز و پرمیوم تلگرام (Fragment)

  • POST/api/purchase/stars

    خرید استارز تلگرام برای هر نام کاربری — تحویل آنی از Fragment.

  • POST/api/purchase/premium

    هدیه پرمیوم تلگرام (۳، ۶ یا ۱۲ ماه) به‌صورت برنامه‌نویسی.

  • GET/api/purchase/pricesPublic

    قیمت لحظه‌ای استارز و پرمیوم به تون.

  • GET/api/purchase/user/{username}

    جستجوی کاربر تلگرام قبل از ثبت سفارش.

NFT گیفت و مارکت‌پلیس

  • POST/api/marketplace/buy/auto

    خرید خودکار NFT گیفت تلگرام و تحویل به کیف پول تون.

  • GET/api/marketplace/collections

    مرور کلکشن‌های NFT، عرضه و قیمت کف.

  • GET/api/marketplace/nft?address=…

    جزئیات NFT، وضعیت فروش و قیمت.

  • GET/api/marketplace/quote?address=…

    دریافت پیش‌فاکتور خرید با کارمزد.

کیف پول و سفارش‌ها

  • GET/api/wallet

    بررسی موجودی تون و آدرس واریز.

  • GET/api/transaction

    تاریخچه سفارش‌های استارز، پرمیوم و NFT.

  • GET/api/marketplace/orders/{id}

    پیگیری وضعیت سفارش خرید NFT.

چرا با تی جی تولز بسازیم

  • هدیه پرمیوم ۳، ۶ یا ۱۲ ماهه با یک درخواست POST
  • اعتبارسنجی گیرنده پیش از سفارش — GET /api/purchase/user/{username} بدون احراز هویت
  • قیمت لحظه‌ای پلن‌ها از GET /api/purchase/prices
  • فعال‌سازی آنی از طریق Fragment.com
  • کلید API خودسرویس، بدون KYC و بدون تماس فروش
  • پرداخت به‌ازای سفارش از کیف پول — بدون اشتراک

ویژگی‌های پلتفرم

  • POST /api/purchase/premium — { recipientUsername, months: 3 | 6 | 12, paymentMethod, trackingCode }
  • GET /api/purchase/user/{username} — found، displayName، premiumEligible (عمومی)
  • GET /api/purchase/prices — premium_3m_ton، premium_6m_ton، premium_12m_ton (عمومی)
  • GET /api/transaction/{id} — status، quotedTotalTon، costTon، providerReference
  • GET /api/wallet — موجودی برای بودجه‌بندی سفارش‌ها
  • همان کلید استارز، گیفت‌کارت، شارژ بازی و گیفت تلگرام را هم می‌خرد

چطور کار می‌کند

  1. 1

    دریافت کلید API

    حساب بسازید و از داشبورد خود کلید API بگیرید.

  2. 2

    یکپارچه‌سازی

    با REST API ما — یا از طریق پنل — استارز و پرمیوم بخرید.

  3. 3

    مانیتورینگ

    هر سفارش، موجودی کیف پول و تاریخچه را لحظه‌ای دنبال کنید.

سوالات پرتکرار

چطور با API پرمیوم تلگرام هدیه بدهم؟

POST /api/purchase/premium را با recipientUsername و months (۳، ۶ یا ۱۲) و هدر X-Api-Key بفرستید. پاسخ شامل transactionId و status است و فعال‌سازی از طریق Fragment.com انجام می‌شود.

می‌توانم بررسی کنم یک نام کاربری می‌تواند پرمیوم بگیرد؟

بله. GET /api/purchase/user/{username} عمومی است و found و premiumEligible را برمی‌گرداند تا پیش از دریافت وجه از مشتری اعتبارسنجی کنید.

قیمت پرمیوم تلگرام از طریق API چقدر است؟

قیمت عمده لحظه‌ای پلن‌های ۳، ۶ و ۱۲ ماهه را GET /api/purchase/prices به تون برمی‌گرداند؛ نرخ برای همه کلیدها یکسان است.

چطور کلید API پرمیوم تلگرام بگیرم؟

حساب رایگان تی جی تولز بسازید، به تنظیمات ← کلیدهای API بروید و کلید بسازید — تا ۵ کلید فعال. مستندات در /api-docs است.

هزینه ماهانه دارد؟

خیر. دسترسی به API رایگان است؛ فقط بهای هدیه‌های پرمیومی که سفارش می‌دهید از موجودی کیف پول کم می‌شود.

کلید چه کارهای دیگری می‌کند؟

خرید استارز تلگرام (POST /api/purchase/stars)، گیفت‌کارت و شارژ بازی (POST /api/catalog/buy) و گیفت‌های کلکسیونی تلگرام (POST /api/marketplace/buy/auto).

آماده شروع هستید؟

در چند ثانیه ثبت‌نام کنید. بدون هزینه پنهان. تحویل آنی.