BuyTgPremium

Telegram PremiumとTelegramスターのAPI

独自のアプリ、ボット、ショップからTelegram PremiumとTelegramスターのギフトを送信できます。JSONを使用した小さなREST API、1つの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クレジット（USD）
GET/productsPremiumの期間と価格、スターの範囲とパッケージ
GET/recipient?username=ユーザー名を確認：個人、チャンネル、グループ、ボットまたは見つからない
POST/quote注文の価格とクレジットが足りるかどうか
POST/ordersクレジットから支払われるギフト注文を確定
GET/orders?limit=&batch=最近の注文（最大100件）
GET/orders/{code}コードによる1つの注文

注文の確定

Premium：商品"premium"、期間3、6、12ヶ月、最大10ユーザーまで。スター：商品"stars"、3,500から550,000スター、1ユーザー宛。合計額は残高から一括引き落とされ、受信者ごとに注文が生成されます。

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参照）

制限と安全性

  • キーごとに1分あたり120リクエスト。10分ごとに60回の受取人チェック。
  • アカウントごとに1つのキー。キーを変更すると古いキーは即時無効化されます
  • キーはサーバー上に保管してください。Webページやモバイルアプリに埋め込まないでください
Telegram PremiumとTelegramスターのAPI for Resellers and Bots | BuyTgPremium