টেলিগ্রাম প্রিমিয়াম এবং স্টার্স API
আপনার নিজস্ব অ্যাপ, বট বা দোকান থেকে টেলিগ্রাম প্রিমিয়াম এবং টেলিগ্রাম স্টার্স উপহার পাঠান। একটি ছোট REST API যাতে JSON, একটি 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, এবং প্রাপকদের মধ্যে 10 পর্যন্ত usernames। Stars: পণ্য "stars", Stars 3,500 থেকে 550,000 পর্যন্ত, এবং প্রাপকের মধ্যে একটি username। মোটটি আপনার ক্রেডিট থেকে একবারে নেওয়া হয় এবং প্রতিটি প্রাপকের জন্য একটি অর্ডার তৈরি করা হয়।
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 | প্রতি কী প্রতি মিনিটে 120 এর বেশি অনুরোধ (429, Retry-After দেখুন) |
সীমা এবং নিরাপত্তা
- প্রতি কী প্রতি মিনিটে 120 অনুরোধ; প্রতি 10 মিনিটে 60 প্রাপক চেক।
- প্রতি অ্যাকাউন্টে একটি কী। এটি প্রতিস্থাপন করলে পুরানো কী অবিলম্বে বন্ধ হয়ে যায়।
- কীটি আপনার সার্ভারে রাখুন। এটি কখনও একটি ওয়েব পৃষ্ঠা বা মোবাইল অ্যাপে রাখবেন না।