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 رایگان است. فقط هزینه استارز، پرمیوم یا 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
دریافت کلید API
حساب بسازید و از داشبورد خود کلید API بگیرید.
- 2
یکپارچهسازی
با REST API ما — یا از طریق پنل — استارز و پرمیوم بخرید.
- 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).
آماده شروع هستید؟
در چند ثانیه ثبتنام کنید. بدون هزینه پنهان. تحویل آنی.
