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