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

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

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

    دریافت کلید API

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

  2. 2

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

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

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

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

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