للمطورين والبائعين

واجهة API لبطاقات الهدايا

بِع بطاقات الهدايا وشحن الألعاب من بوتك أو متجرك — كتالوج واحد، طلب POST واحد، والكود يصلك عبر الواجهة.

تمنح واجهة API لبطاقات الهدايا من TGTools بوتك أو متجرك أو منصتك كتالوج جملة لبطاقات الهدايا وشحن الألعاب خلف مفتاح REST واحد. يسرد GET /api/catalog المنتجات حسب الفئة — بطاقات هدايا مثل Steam وApple وPlayStation وAmazon، وشحن ألعاب مثل PUBG Mobile وFree Fire — مع متغيرات إقليمية وسعر التجزئة بالدولار وأسعار TON المباشرة، ولا يحتاج إلى مصادقة. يعيد GET /api/catalog/item منتجًا واحدًا بكل فئاته. للطلب أرسل POST /api/catalog/buy مع productId والكمية، وللألعاب playerId؛ تتم معالجة الطلب تلقائيًا ويعيد GET /api/catalog/orders/{id} كود التسليم deliveryCode عند الاكتمال. لشحن محفظة Steam نقاط نهاية خاصة تحت /api/steam-topup بأسعار وعروض مباشرة. المفاتيح ذاتية من لوحة التحكم، لا اشتراك، وتُدفع الطلبات من رصيد محفظتك.

معاينة نقاط نهاية API

مفتاح API مجاني · بدون KYC
وثائق API الكاملة →

لا حاجة للتحقق من الهوية — سجّل، أنشئ مفتاح API، وابدأ إرسال الطلبات خلال دقائق.

الوصول إلى API مجاني. تدفع فقط مقابل النجوم أو البريميوم أو NFT من رصيد محفظة TON.

المصادقة: X-Api-Key: tgt_… أو Authorization: Bearer tgt_…

الرابط الأساسي: https://api.tg-tools.shop

نجوم وبريميوم تليجرام (Fragment)

  • POST/api/purchase/stars

    شراء نجوم تليجرام لأي اسم مستخدم — تسليم فوري عبر Fragment.

  • POST/api/purchase/premium

    إهداء بريميوم تليجرام (3 أو 6 أو 12 شهرًا) برمجيًا.

  • GET/api/purchase/pricesPublic

    أسعار النجوم والبريميوم الحية بـ TON.

  • GET/api/purchase/user/{username}

    البحث عن مستخدم تليجرام قبل الطلب.

NFT الهدايا والسوق

  • POST/api/marketplace/buy/auto

    شراء NFT هدية تليجرام تلقائيًا وإرساله إلى محفظة TON.

  • GET/api/marketplace/collections

    تصفح مجموعات NFT والعرض وأسعار الأرضية.

  • GET/api/marketplace/nft?address=…

    تفاصيل NFT وحالة البيع والسعر.

  • GET/api/marketplace/quote?address=…

    عرض سعر الشراء مع الرسوم قبل الدفع.

المحفظة والطلبات

  • GET/api/wallet

    التحقق من رصيد TON وعنوان الإيداع.

  • GET/api/transaction

    سجل طلبات النجوم والبريميوم وNFT.

  • GET/api/marketplace/orders/{id}

    تتبع حالة طلب شراء NFT.

لماذا تبني مع تی جی تولز

  • كتالوج عام — GET /api/catalog و /api/catalog/item دون مفتاح
  • بطاقات هدايا وشحن ألعاب بمتغيرات إقليمية وأسعار TON مباشرة
  • طلب POST واحد للشراء، وكود التسليم يعود عبر الواجهة
  • شحن محفظة Steam بأسعار مباشرة عبر /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 — تسعير محفظة Steam
  • POST /api/steam-topup/buy — { steamLogin, currency, amount }

كيف يعمل

  1. 1

    احصل على مفتاح API

    أنشئ حسابًا وولّد مفتاح API من لوحة التحكم.

  2. 2

    التكامل

    استخدم واجهة REST API — أو اللوحة — لشراء النجوم والبريميوم.

  3. 3

    المراقبة

    تابع كل طلب ورصيد المحفظة والسجل لحظيًا.

الأسئلة الشائعة

ما بطاقات الهدايا التي يمكنني شراؤها عبر الواجهة؟

كل ما في الكتالوج المباشر: يعيد GET /api/catalog?category=giftcards بطاقات هدايا إقليمية (Steam وApple وPlayStation وAmazon وغيرها) مع الفئات والأسعار الحالية.

كيف تُسلَّم بطاقة الهدايا؟

بعد POST /api/catalog/buy تتم معالجة الطلب تلقائيًا؛ استعلم عن GET /api/catalog/orders/{id} — يمتلئ حقل deliveryCode عندما تصبح الحالة Completed.

هل يمكنني شراء شحن الألعاب أيضًا؟

نعم. استخدم category=topups؛ المنتجات التي تحتاج حساب لاعب تحمل requiresPlayerId، وتمرر playerId في طلب الشراء.

هل أحتاج حسابًا لقراءة الكتالوج؟

لا. نقاط نهاية الكتالوج والمنتج عامة؛ يتطلب /api/catalog/buy وسجل الطلبات فقط مفتاح API.

كيف تُدفع الطلبات؟

من رصيد محفظتك في TGTools بعملة TON. أسعار الكتالوج مباشرة، ولا اشتراك ولا رسوم لكل طلب.

كيف أحصل على مفتاح API لبطاقات الهدايا؟

أنشئ حسابًا مجانيًا، افتح الإعدادات ← مفاتيح API وولّد مفتاحًا (حتى خمسة). الوثائق على /api-docs.

جاهز للبدء؟

سجّل خلال ثوانٍ. بدون رسوم خفية. تسليم فوري.