BuyTgPremium

टेलीग्राम प्रीमियम और स्टार्स API

अपने खुद के ऐप, बॉट या शॉप से टेलीग्राम प्रीमियम और टेलीग्राम स्टार्स गिफ्ट भेजें। JSON के साथ एक छोटा REST API, एक API की, और साइट पर उसी कीमत पर आपके क्रेडिट से भुगतान किए गए ऑर्डर।

शुरुआत करें

  • क्रेडिट पेज पर अकाउंट बनाएं और क्रेडिट जोड़ें।
  • मेरा अकाउंट खोलें, फिर API, और अपना API की बनाएं। यह एक बार दिखाया जाता है, इसलिए इसे अपने सर्वर पर स्टोर करें।
  • प्रत्येक अनुरोध के साथ X-Api-Key हेडर में कुंजी भेजें।

बेस URL और फॉर्मेट

सभी रिक्वेस्ट HTTPS और JSON का उपयोग करती हैं। एक सफलता का उत्तर { "ok": true, "data": ... } होता है। एक त्रुटि का उत्तर { "ok": false, "error": { "code", "message" } } होता है जिसमें एक स्थिर कोड होता है।

https://buytgpremium.com/api/v1

curl https://buytgpremium.com/api/v1/balance \
  -H "X-Api-Key: btk_YOUR_KEY"

{ "ok": true, "data": { "credit": "120.00", "currency": "USD" } }

एंडपॉइंट्स

विधिपाथयह क्या करता है
GET/balanceUSD में आपका क्रेडिट
GET/productsप्रीमियम अवधि और कीमतें, स्टार्स रेंज और पैकेज
GET/recipient?username=एक यूजरनेम चेक करता है: व्यक्ति, चैनल, ग्रुप, बॉट या नहीं मिला
POST/quoteएक ऑर्डर की कीमत और क्या आपका क्रेडिट इसे कवर करता है
POST/ordersक्रेडिट से भुगतान किया गया एक गिफ्ट ऑर्डर प्लेस करता है
GET/orders?limit=&batch=आपके हाल के ऑर्डर (100 तक)
GET/orders/{code}इसके कोड द्वारा एक ऑर्डर

ऑर्डर प्लेस करना

Premium: उत्पाद "premium", महीने 3, 6 या 12, और recipients में 10 तक usernames। Stars: उत्पाद "stars", Stars 3,500 से 550,000 तक, और recipient में एक username। कुल राशि आपके क्रेडिट से एक बार में ली जाती है और प्रत्येक recipient के लिए एक ऑर्डर बनाया जाता है।

curl -X POST https://buytgpremium.com/api/v1/orders \
  -H "X-Api-Key: btk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product":"premium","months":12,"recipients":["alice","bob"]}'

{ "ok": true, "data": { "batch": "B-7KQ2-...", "total": "34.00", "currency": "USD",
  "orders": [ { "code": "G-4MZ8-...", "product": "premium", "recipient": "alice", "months": 12,
    "price": "17.00", "status": "completed" }, ... ] } }
curl -X POST https://buytgpremium.com/api/v1/orders \
  -H "X-Api-Key: btk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product":"stars","stars":5000,"recipient":"alice"}'

त्रुटि कोड

कोडअर्थ
API कुंजी गुम है / अमान्य API कुंजीकोई की नहीं, या की गलत है या बदल दी गई है (401)
अमान्य इनपुट / अमान्य प्राप्तकर्ताउत्पाद, महीने, सितारे या यूज़रनेम (400) जांचें
recipient_not_userयूज़रनेम एक चैनल, ग्रुप या बॉट है, या मौजूद नहीं है
insufficient_creditक्रेडिट ऑर्डर की कुल राशि से कम है; क्रेडिट जोड़ें
network_errorअस्थायी नेटवर्क त्रुटि; आपका क्रेडिट नहीं बदला है, पुनः प्रयास करें
rate_limitedप्रति कुंजी (429, Retry-After देखें) एक मिनट में 120 से अधिक अनुरोध

सीमाएँ और सुरक्षा

  • प्रति कुंजी 120 अनुरोध प्रति मिनट; प्रति 10 मिनट में 60 प्राप्तकर्ता जांचें।
  • प्रति खाता एक कुंजी। इसे बदलने से पुरानी कुंजी तुरंत बंद हो जाती है।
  • कुंजी को अपने सर्वर पर रखें। इसे कभी भी वेब पेज या मोबाइल ऐप में न डालें।
रीसेलर्स और बॉट्स के लिए टेलीग्राम प्रीमियम और स्टार्स API | BuyTgPremium