टेलीग्राम प्रीमियम और स्टार्स 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 | /balance | USD में आपका क्रेडिट |
| 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 प्राप्तकर्ता जांचें।
- प्रति खाता एक कुंजी। इसे बदलने से पुरानी कुंजी तुरंत बंद हो जाती है।
- कुंजी को अपने सर्वर पर रखें। इसे कभी भी वेब पेज या मोबाइल ऐप में न डालें।