API گیفتکارت
گیفتکارت و شارژ بازی را از ربات یا فروشگاه خودتان بفروشید — یک کاتالوگ، یک POST، تحویل کد از طریق API.
API گیفتکارت تی جی تولز یک کاتالوگ عمده از گیفتکارت و شارژ بازی را پشت یک کلید REST در اختیار ربات، فروشگاه یا پلتفرم شما میگذارد. GET /api/catalog محصولات را بر اساس دسته فهرست میکند — گیفتکارتهایی مثل استیم، اپل، پلیاستیشن و آمازون و شارژهایی مثل پابجی موبایل و فریفایر — با نسخههای منطقهای، قیمت خردهفروشی دلاری و قیمت لحظهای به تون، و به احراز هویت نیاز ندارد. GET /api/catalog/item یک محصول را با همه مبالغ برمیگرداند. برای سفارش، POST /api/catalog/buy را با productId، quantity و برای شارژ بازی playerId بفرستید؛ سفارش خودکار پردازش میشود و GET /api/catalog/orders/{id} پس از تکمیل، deliveryCode را برمیگرداند. شارژ کیف پول استیم اندپوینتهای مخصوص خود را زیر /api/steam-topup با نرخ و پیشفاکتور لحظهای دارد. کلیدها در داشبورد خودسرویس ساخته میشوند، اشتراکی وجود ندارد و سفارشها از موجودی کیف پول پرداخت میشوند.
پیشنمایش اندپوینتهای 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/catalog و /api/catalog/item بدون کلید
- گیفتکارت و شارژ بازی با نسخههای منطقهای و قیمت لحظهای به تون
- یک POST برای سفارش، کد تحویل از طریق API
- شارژ کیف پول استیم با نرخ لحظهای از /api/steam-topup
- کلید API خودسرویس، بدون اشتراک
- همان کلید استارز، پرمیوم و گیفت تلگرام را هم پوشش میدهد
ویژگیهای پلتفرم
- GET /api/catalog?category=giftcards|topups&q=… — محصولات صفحهبندیشده با نسخهها
- GET /api/catalog/item?key=giftcards:amazon — یک محصول با همه مبالغ
- POST /api/catalog/buy — { productId, quantity, playerId? }
- GET /api/catalog/orders و /api/catalog/orders/{id} — وضعیت و deliveryCode
- GET /api/steam-topup/rates و /quote — قیمتگذاری کیف پول استیم
- POST /api/steam-topup/buy — { steamLogin, currency, amount }
چطور کار میکند
- 1
دریافت کلید API
حساب بسازید و از داشبورد خود کلید API بگیرید.
- 2
یکپارچهسازی
با REST API ما — یا از طریق پنل — استارز و پرمیوم بخرید.
- 3
مانیتورینگ
هر سفارش، موجودی کیف پول و تاریخچه را لحظهای دنبال کنید.
سوالات پرتکرار
چه گیفتکارتهایی را میتوانم با API بخرم؟
هر چه در کاتالوگ زنده باشد: GET /api/catalog?category=giftcards گیفتکارتهای منطقهای (استیم، اپل، پلیاستیشن، آمازون و بیشتر) را با مبالغ و قیمت فعلی برمیگرداند.
گیفتکارت چطور تحویل میشود؟
پس از POST /api/catalog/buy سفارش خودکار پردازش میشود؛ GET /api/catalog/orders/{id} را بررسی کنید — وقتی وضعیت Completed شد، فیلد deliveryCode پر میشود.
شارژ بازی هم میتوانم بخرم؟
بله. از category=topups استفاده کنید؛ محصولاتی که به حساب بازیکن نیاز دارند requiresPlayerId دارند و playerId را در درخواست خرید میفرستید.
برای خواندن کاتالوگ به حساب نیاز دارم؟
خیر. اندپوینتهای کاتالوگ و آیتم عمومیاند؛ فقط /api/catalog/buy و تاریخچه سفارشها کلید API میخواهند.
سفارشها چطور پرداخت میشوند؟
از موجودی کیف پول تی جی تولز به تون. قیمتهای کاتالوگ لحظهایاند و اشتراک یا کارمزد بهازای درخواست وجود ندارد.
چطور کلید API گیفتکارت بگیرم؟
حساب رایگان بسازید، به تنظیمات ← کلیدهای API بروید و کلید بسازید (تا ۵ کلید). مستندات در /api-docs است.
آماده شروع هستید؟
در چند ثانیه ثبتنام کنید. بدون هزینه پنهان. تحویل آنی.
