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

واجهة API لبريميوم تليجرام

أهدِ بريميوم تليجرام لأي اسم مستخدم من بوتك أو متجرك أو منصتك بطلب REST واحد.

واجهة API لبريميوم تليجرام من TGTools هي نقطة نهاية REST لإهداء البريميوم برمجيًا. أرسل POST /api/purchase/premium مع اسم مستخدم المستلم وخطة 3 أو 6 أو 12 شهرًا، وصادِق عبر ترويسة X-Api-Key، فيتم تفعيل الاشتراك عبر Fragment.com خلال ثوانٍ. قبل الطلب، يؤكد GET /api/purchase/user/{username} وجود الحساب وأهليته للبريميوم، ويعيد GET /api/purchase/prices أسعار الخطط المباشرة بعملة TON — كلاهما دون مصادقة. تنشئ مفتاح API بنفسك من لوحة التحكم، حتى خمسة مفاتيح نشطة، دون استمارة طلب أو محادثة مبيعات. لا يوجد اشتراك ولا رسوم لكل طلب: تُدفع الطلبات من رصيد محفظتك في TGTools، وكل استجابة JSON متوقعة، ولكل مفتاح سجل استدعاءات خاص في لوحة التحكم.

معاينة نقاط نهاية 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.

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

  • إهداء بريميوم 3 أو 6 أو 12 شهرًا بطلب POST واحد
  • تحقق من المستلم أولًا — GET /api/purchase/user/{username} دون مصادقة
  • أسعار الخطط المباشرة من GET /api/purchase/prices
  • تفعيل فوري عبر Fragment.com
  • مفتاح API ذاتي، دون KYC ودون محادثة مبيعات
  • ادفع لكل طلب من محفظتك — دون اشتراك

ميزات المنصة

  • POST /api/purchase/premium — { recipientUsername, months: 3 | 6 | 12, paymentMethod, trackingCode }
  • GET /api/purchase/user/{username} — found و displayName و premiumEligible (عام)
  • GET /api/purchase/prices — premium_3m_ton و premium_6m_ton و premium_12m_ton (عام)
  • GET /api/transaction/{id} — status و quotedTotalTon و costTon و providerReference
  • GET /api/wallet — الرصيد لتخطيط ميزانية الطلبات
  • المفتاح نفسه يشتري النجوم وبطاقات الهدايا وشحن الألعاب وهدايا تليجرام

كيف يعمل

  1. 1

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

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

  2. 2

    التكامل

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

  3. 3

    المراقبة

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

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

كيف أهدي بريميوم تليجرام عبر الواجهة؟

أرسل POST /api/purchase/premium مع recipientUsername و months (3 أو 6 أو 12) وترويسة X-Api-Key. تتضمن الاستجابة transactionId و status، ويتم التفعيل عبر Fragment.com.

هل يمكنني التحقق من أهلية اسم مستخدم للبريميوم؟

نعم. GET /api/purchase/user/{username} عام ويعيد found و premiumEligible لتتحقق قبل تحصيل المبلغ من عميلك.

كم يكلف بريميوم تليجرام عبر الواجهة؟

يعيد GET /api/purchase/prices أسعار الجملة المباشرة لخطط 3 و6 و12 شهرًا بعملة TON، وتنطبق الأسعار نفسها على كل المفاتيح.

كيف أحصل على مفتاح API للبريميوم؟

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

هل هناك رسوم شهرية؟

لا. الوصول إلى الواجهة مجاني؛ تدفع فقط ثمن هدايا البريميوم التي تطلبها من رصيد محفظتك.

ماذا يفعل المفتاح أيضًا؟

شراء نجوم تليجرام (POST /api/purchase/stars) وبطاقات الهدايا وشحن الألعاب (POST /api/catalog/buy) وهدايا تليجرام القابلة للجمع (POST /api/marketplace/buy/auto).

جاهز للبدء؟

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