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

واجهة 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، وابدأ إرسال الطلبات خلال دقائق.

الوصول إلى 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. 1

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

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

  2. 2

    التكامل

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

  3. 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.

جاهز للبدء؟

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