واجهة API لهدايا تليجرام
اشترِ هدايا تليجرام القابلة للجمع برمجيًا وسلّمها إلى أي محفظة TON.
تتيح واجهة API لهدايا تليجرام من TGTools لبوتك أو منصتك شراء هدايا تليجرام القابلة للجمع — الهدايا المطوّرة التي توجد كرموز NFT على TON — بطلب REST واحد. يعيد GET /api/marketplace/quote الإجمالي لهدية محددة مقسّمًا إلى سعر الإدراج ورسوم المنصة واحتياطي الغاز، مع canBuy. ثم يشتري POST /api/marketplace/buy/auto الهدية ويسلّمها إلى recipientTonAddress الذي تحدده؛ ويتتبع GET /api/marketplace/orders/{id} الطلب حتى يصبح Complete. يمكن تصفح المجموعات والعناصر عبر نقاط النهاية العامة للسوق، فتبني فوق ذلك متجر هدايا أو أمر بوت أو مشتريًا آليًا. تُنشأ المفاتيح ذاتيًا من لوحة التحكم، لا اشتراك، ويُدفع كل طلب من رصيد محفظتك بالإجمالي المعروض بعملة TON.
معاينة نقاط نهاية 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/marketplace/quote السعر والرسوم والغاز قبل الشراء
- طلب POST واحد يشتري الهدية ويسلّمها إلى أي عنوان TON
- حالة الطلب عبر الواجهة حتى اكتمال التسليم
- تصفّح المجموعات والعناصر برمجيًا
- مفتاح 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
احصل على مفتاح API
أنشئ حسابًا وولّد مفتاح API من لوحة التحكم.
- 2
التكامل
استخدم واجهة REST API — أو اللوحة — لشراء النجوم والبريميوم.
- 3
المراقبة
تابع كل طلب ورصيد المحفظة والسجل لحظيًا.
الأسئلة الشائعة
ما هو NFT هدية تليجرام؟
هدية تليجرام مطوّرة مسكوكة كرمز NFT قابل للجمع على بلوكتشين TON، يمكن شراؤها ونقلها وعرضها كأي NFT آخر.
كيف أشتري هدية عبر الواجهة؟
استدعِ GET /api/marketplace/quote بعنوان الهدية، ثم POST /api/marketplace/buy/auto مع nftAddress و recipientTonAddress و clientOrderId. تتبّعها عبر GET /api/marketplace/orders/{id}.
إلى أين تُسلَّم الهدية؟
إلى عنوان محفظة TON الذي تمرره في recipientTonAddress — محفظتك أو محفظة عميلك.
كم يكلف الطلب؟
يعرض عرض السعر سعر الإدراج ورسوم المنصة واحتياطي الغاز؛ يُخصم الإجمالي من رصيد محفظتك بعملة TON.
هل يمكنني بيع الهدايا عبر الواجهة؟
مسار التكامل الموثّق هو التصفح وعرض السعر والشراء. إدراج الهدايا للبيع يتم من تطبيق الويب TGTools على /sales.
كيف أحصل على مفتاح API لهدايا تليجرام؟
أنشئ حسابًا مجانيًا، افتح الإعدادات ← مفاتيح API وولّد مفتاحًا (حتى خمسة). الوثائق على /api-docs.
جاهز للبدء؟
سجّل خلال ثوانٍ. بدون رسوم خفية. تسليم فوري.
