BuyTgPremium

Telegram Premium及Stars API

從您的應用程式、機械人或商店發送Telegram Premium及Telegram Stars禮物。簡潔REST API採用JSON格式，單一API密鑰，訂單價格與網站相同並從您的餘額支付。

開始使用

  • 於帳戶頁面創建帳戶並充值餘額。
  • 開啟「我的帳戶」後選擇API，創建您的API密鑰。密鑰僅顯示一次，請妥善儲存於伺服器。
  • 請在每次請求時於 X-Api-Key 標頭中發送密鑰。
創建 API 密鑰

基礎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您的餘額（美元）
GET/productsPremium有效期及價格，Stars範圍及套餐
GET/recipient?username=檢查用戶名：個人、頻道、群組、機械人或未找到
POST/quote訂單價格及餘額是否足夠支付
POST/orders從餘額支付下達禮物訂單
GET/orders?limit=&batch=您最近的訂單（最多100筆）
GET/orders/{code}按訂單編碼查詢單筆訂單

下訂單

Premium：產品 "premium"，時長 3、6 或 12 個月，最多 10 個 username 作為接收者。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 次收件人檢查。
  • 每個帳戶一個密鑰。替換後舊密鑰立即失效。
  • 請將密鑰保存在伺服器上。切勿放入網頁或手機應用程式。
Telegram Premium及Stars API（供經銷商及機械人使用）| BuyTgPremium