API گیفت تلگرام
گیفتهای کلکسیونی تلگرام را بهصورت برنامهنویسی بخرید و به هر کیف پول TON تحویل دهید.
API گیفت تلگرام تی جی تولز به ربات یا پلتفرم شما اجازه میدهد گیفتهای کلکسیونی تلگرام — گیفتهای ارتقایافتهای که بهصورت NFT روی TON هستند — را با یک فراخوانی REST بخرد. GET /api/marketplace/quote مبلغ کل یک گیفت مشخص را با تفکیک قیمت لیستینگ، کارمزد پلتفرم و ذخیره گس به همراه canBuy برمیگرداند. سپس POST /api/marketplace/buy/auto گیفت را میخرد و به recipientTonAddress که مشخص میکنید تحویل میدهد؛ GET /api/marketplace/orders/{id} سفارش را تا وضعیت Complete پیگیری میکند. کلکسیونها و آیتمها با اندپوینتهای عمومی مارکت قابل مرور هستند، پس میتوانید فروشگاه گیفت، دستور ربات یا خریدار خودکار روی آن بسازید. کلیدها بهصورت خودسرویس در داشبورد ساخته میشوند، اشتراکی وجود ندارد و هر سفارش با مبلغ پیشفاکتور به تون از موجودی کیف پول پرداخت میشود.
پیشنمایش اندپوینتهای 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.
چرا با تی جی تولز بسازیم
- اول پیشفاکتور — GET /api/marketplace/quote قیمت، کارمزد و گس را پیش از خرید نشان میدهد
- یک POST گیفت را میخرد و به هر آدرس TON تحویل میدهد
- وضعیت سفارش از طریق API تا تکمیل تحویل
- مرور برنامهنویسیشده کلکسیونها و آیتمها
- کلید API خودسرویس، پرداخت بهازای سفارش از کیف پول
- همان کلید استارز، پرمیوم و گیفتکارت را هم پوشش میدهد
ویژگیهای پلتفرم
- GET /api/marketplace/quote?address=… — listingPriceTon، platformFeeTon، gasBufferTon، totalPriceTon، canBuy
- POST /api/marketplace/buy/auto — { nftAddress, recipientTonAddress, clientOrderId }
- GET /api/marketplace/orders/{id} — status، totalPriceTon، nftName
- GET /api/marketplace/collections و /collections/{address}/items — مرور کاتالوگ
- GET /api/marketplace/nft و /nft-by-slug — یک گیفت با آدرس یا اسلاگ
- سفارشهای تکرارناپذیر با clientOrderId
چطور کار میکند
- 1
دریافت کلید API
حساب بسازید و از داشبورد خود کلید API بگیرید.
- 2
یکپارچهسازی
با REST API ما — یا از طریق پنل — استارز و پرمیوم بخرید.
- 3
مانیتورینگ
هر سفارش، موجودی کیف پول و تاریخچه را لحظهای دنبال کنید.
سوالات پرتکرار
NFT گیفت تلگرام چیست؟
یک گیفت ارتقایافته تلگرام که بهصورت NFT کلکسیونی روی بلاکچین TON ضرب شده است و مثل هر NFT دیگری قابل خرید، انتقال و نمایش است.
چطور با API گیفت بخرم؟
GET /api/marketplace/quote را با آدرس گیفت صدا بزنید، سپس POST /api/marketplace/buy/auto را با nftAddress، recipientTonAddress و clientOrderId بفرستید. با GET /api/marketplace/orders/{id} پیگیری کنید.
گیفت به کجا تحویل میشود؟
به آدرس کیف پول TON که در recipientTonAddress میفرستید — کیف پول خودتان یا مشتریتان.
یک سفارش چقدر هزینه دارد؟
پیشفاکتور قیمت لیستینگ، کارمزد پلتفرم و ذخیره گس را جدا نشان میدهد؛ مبلغ کل به تون از موجودی کیف پول کم میشود.
میتوانم با API گیفت بفروشم؟
روند مستندشده برای یکپارچهسازی مرور، پیشفاکتور و خرید است. لیستکردن گیفت برای فروش از اپ وب تی جی تولز در /sales انجام میشود.
چطور کلید API گیفت تلگرام بگیرم؟
حساب رایگان بسازید، به تنظیمات ← کلیدهای API بروید و کلید بسازید (تا ۵ کلید). مستندات در /api-docs است.
آماده شروع هستید؟
در چند ثانیه ثبتنام کنید. بدون هزینه پنهان. تحویل آنی.
