واجهة 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 مجاني. تدفع فقط مقابل النجوم أو البريميوم أو 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
احصل على مفتاح API
أنشئ حسابًا وولّد مفتاح API من لوحة التحكم.
- 2
التكامل
استخدم واجهة REST API — أو اللوحة — لشراء النجوم والبريميوم.
- 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.
جاهز للبدء؟
سجّل خلال ثوانٍ. بدون رسوم خفية. تسليم فوري.
