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

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 بسازید و در چند دقیقه سفارش بفرستید.

دسترسی 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. 1

    دریافت کلید API

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

  2. 2

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

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

  3. 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 است.

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

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