SMMパネル API ドキュメント

SMMパネル API とは?

SMMパネル API を使うと、サイトを開かなくてもプログラムからサービス一覧の取得、注文、注文状況や残高の確認ができます。4SNS PLUS は多くのパネルやボットで使われている標準の SMMパネル API v2 形式に対応しているため、他のパネルにつないでいたコードも URL とキーを変えるだけですぐに動きます。

API の価格と残高はサイトと同じです。services のレスポンスにある rate は料金表の 1,000 あたりの価格 (米ドル) と同じで、add で出した注文はサイトでの注文と同じく残高から差し引かれ、ダッシュボードの注文履歴にも表示されます。キャンセルや一部完了の注文で戻る金額も同じ残高に返金されます。

基本情報

リクエスト例

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

API キーの取得方法は?

初回のチャージが残高に反映されると、ダッシュボードの API キーメニューから API キーを作成できます。キーは作成時に一度だけ表示されるので、安全な場所に保管してください。新しいキーを作成すると、以前のキーはすぐに無効になります。

API キーはアカウントのトークンとは別のものです。ボットやサーバーには API キーだけを設定し、アカウントのトークンは入れないでください。キーが漏れたと思われる場合は、API キー画面で新しいキーを作成するだけで大丈夫です。

サービス一覧 (services)

注文できるすべてのサービスを返します。rate は 1,000 あたりの価格 (USD) で、type が Package の場合は 1 パッケージの価格です。type が Custom Comments の場合は、数量の代わりにコメントの一覧を送ります。category はプラットフォーム名とグループ名を合わせたものです。

レスポンス例

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

注文の追加 (add)

注文を出し、金額を残高から差し引きます。金額は 1,000 あたりの価格 × 数量で、Package はパッケージ価格、Custom Comments はコメントの行数が数量になります。注文は初回のチャージが反映されたアカウントで利用できます。レスポンスの order が注文 ID です。

レスポンス例

{
  "order": 31877
}

注文状況 (status)

1 件の注文の状況です。charge は返金後の実際の支払額 (USD、小数点以下 6 桁)、start_count は注文開始時の数、remains はまだ届いていない数量です。

レスポンス例

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

複数注文の状況 (status, orders)

注文 ID をカンマでつなぎ、最大 100 件の注文を一度に確認できます。存在しない ID やご自身のアカウントにない ID には、その位置にエラーが返ります。

レスポンス例

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

リフィルの申請 (refill)

リフィル期間のあるサービスで、Completed または Partial で終わった注文は、終了時点から数えたリフィル期間内に申請できます。1 件の注文で同時に出せる申請は 1 つで、申請の間隔は 24 時間です。

レスポンス例

{
  "refill": 512
}

リフィル状況 (refill_status)

1 件のリフィル申請の状況です。

レスポンス例

{
  "status": "Completed"
}

残高 (balance)

残高です (USD、小数点以下 6 桁)。

レスポンス例

{
  "balance": "84.120000",
  "currency": "USD"
}

注文状況の値

リフィル状況の値

エラーメッセージ

エラーは HTTP 200 のレスポンスで、error 項目付きの JSON として返ります。コードでは最初に error 項目の有無を確認してください。

{
  "error": "Not enough funds on balance"
}

SMMパネル API をテレグラム ボットにつなぐ方法は?