ホーム / 開発者向け / Orders API

Orders API

smm.guideをプロバイダーとしてパネルに追加します。アカウントで作成した各ルートは、固有のIDを持つサービスになります。パネルがそのIDに注文を送ると、ルートは注文を引き受けられる最初のプロバイダーに注文を渡します。

3つのステップ

SMMパネル同士ですでに使われている形式なので、プログラミングは不要です。

1ルートを作成アカウント → Orders desk → ルート。提供するものを選び、接続済みのパネルからその種類のサービスを最大5つ追加します。
2キーを作成Orders desk → Orders API。キーは1回だけ表示されます。パネルのサーバーのアドレスからのみ使えるように制限できます。
3パネルにプロバイダーを追加API URL https://smm.guide/api/v2 とキーを入力します。サービスをインポートすると、ルートがID、価格、数量の上下限とともに取り込まれます。

リクエスト形式

HTTPメソッドPOST
API URLhttps://smm.guide/api/v2
ボディapplication/x-www-form-urlencoded、または次を指定したJSON: Content-Type: application/json. A multipart/form-data 形式のボディも読み取ります。PHPでcURLに配列を渡した場合に送信される形式です
レスポンスJSON。読み取れないボディや大きすぎるリクエストの場合も含め、常にHTTP 200で返します。エラーの形式: {"error": "…"}
金額米ドル。価格は1,000件あたり

サービス一覧

現在注文を引き受けられるルート。オフになっているルートや、すべてのステップが除外されているルートは表示されません。

パラメーター説明
keyあなたのAPIキー
actionservices

レスポンス

[
  {
    "service": 85725095,
    "name": "TG views, main",
    "type": "Default",
    "category": "Telegram views",
    "rate": "0.0018",
    "min": "10",
    "max": "1000000",
    "refill": false,
    "cancel": true,
    "dripfeed": false
  }
]

rate は、注文を引き受ける可能性のあるルートのステップのうち最も高い価格です。一時的にスキップされているステップも含みます(今日停止しているパネルも明日には復帰するため)。そのため、注文がパネルにインポートされた価格を上回ることはありません。 min と max は、稼働中のステップ全体で受け付けられる最も広い範囲です。一部のステップにしか収まらない数量は、そのいずれかに送られます。 refill と cancel は、該当するすべてのステップが対応している場合にtrueになります。

オフになっているルートや、稼働できるステップがないルートは、復帰するまでこの一覧から外れます。サービスを自動同期しているパネルでは、その間そのサービスがパネル側でもオフになります。注文は拒否されるため、これが望ましい動作です。

注文を追加

パラメーター説明
keyあなたのAPIキー
actionadd
serviceルートのID(8桁)
linkページ、投稿、プロフィールへのリンク
quantity必要な数量

レスポンス

{
  "order": 23501
}

受け付けたパネルがありません

{
  "error": "No step of this route accepted the order. …"
}

注文番号は、最終的にどのプロバイダーが配信しても、注文の全期間を通じて変わりません。ルートが受け付けるのはリンクと数量のみで、ドリップフィード、コメント、その他の追加フィールドは拒否されます。

注文ステータス

パラメーター説明
keyあなたのAPIキー
actionstatus
order注文ID

レスポンス

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
パラメーター説明
keyあなたのAPIキー
actionstatus
ordersカンマ区切りの注文ID(最大100件)

レスポンス

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
ステータス意味
Pendingプロバイダーが受け付け、まだ開始していない状態です。プロバイダーから明確な応答がなかった注文もこのステータスになり、アカウントで確認するまでルートはそこで停止します。
In progress, Processingプロバイダーが配信中か、注文が次のステップに移行中です。
Completedすべて配信されました。
Partial一部のみ配信。 remains は未配信の数量です。すべてのステップの配信分を合計します。あるステップが一部を配信し、残りが次のステップでキャンセルされた場合、注文はCanceledではなくPartialになります。残りの請求額を返金するかどうかはプロバイダーが判断します。
Canceled何も配信されず、他のステップも注文を引き受けませんでした。 charge は、請求が残った金額を示します(ある場合)。

charge は、この注文に対してプロバイダーが請求した金額です。注文日の為替レートで米ドルに換算しています。 start_count は、注文を開始したプロバイダーから取得します。

残高

smm.guideはあなたのお金を預かりません。この数値は、ルートの背後にあるパネル上の残高の合計を米ドルで示したものです。

パラメーター説明
keyあなたのAPIキー
actionbalance

レスポンス

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

キャンセル

現在注文を保持しているプロバイダーに、そのサービスがキャンセルに対応していれば転送されます。キャンセルした注文が次のステップに送られることはありません。

パラメーター説明
keyあなたのAPIキー
actioncancel
ordersカンマ区切りの注文ID(最大100件)

レスポンス

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

リフィル

注文を配信したプロバイダーに転送されます。リフィルには注文自体の番号が付きます。

パラメーター説明
keyあなたのAPIキー
actionrefill
order注文ID。または orders:複数をカンマ区切りで指定

レスポンス(注文1件)

{ "refill": "23501" }

レスポンス(複数)

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
パラメーター説明
keyあなたのAPIキー
actionrefill_status
refillリフィルID。または refills:複数をカンマ区切りで指定

レスポンス

{ "status": "Completed" }

ルートによる注文の処理

  • ステップは指定した順、または稼働中で最も安いものから試行されます。 どちらにするかはルートで選択します。
  • ステップがスキップされるのは、 パネルが応答しない場合、残高や1日の上限が注文に足りない場合、数量が受付範囲外の場合、価格が設定した上限を超える場合、またはその価格で注文するとルート自体の1日の上限を超える場合です。自動で復帰します。
  • ステップが除外されるのは、 そのサービスが価格表から消えた場合、またはパネルが同じIDで別のものを販売し始めた場合です。他のステップは引き続き稼働し、通知が届きます。
  • 拒否されると、注文は次に回されます。 パネルが応答して拒否した場合は何も請求されていないため、次のステップが試行されます。
  • 明確な応答がなければ停止します。 タイムアウトや不正な応答では、注文が存在するかどうかわかりません。次に回すと二重に配信・請求されるおそれがあるため、ルートは停止します。その注文をアカウントで確認してください。
  • 1つのリンクにつき実行中の注文は1件。 あるリンクの注文がルートで実行中の間は、同じリンクへの2件目の注文は拒否されます。プロバイダー自身も同様の処理をしています。
  • 配信前にキャンセルされた注文も、 設定をオンにしていれば次に回されます。一部完了の注文の未配信分が次に回されるのは、そのように設定した場合のみです。

エラー

エラー意味
Invalid API keyキーが間違っているか、再発行または無効化されています。
This key is limited to certain addresses…キーの許可リストにないアドレスからリクエストされました。
Incorrect request不明 action.
Incorrect service IDこのIDのルートはありません。削除したルートの番号はそのまま残り、他のルートに割り当てられることはありません。
Incorrect order IDこの番号の注文はありません。
Link is required, Quantity is requiredフィールド add のいずれかが未指定か、数値ではありません。
A route takes a link and a quantity onlyリクエストにドリップフィード、コメント、その他の追加フィールドが含まれていました。
This route is switched offアカウントでオンにしてください。
This route already has an order for this link…実行中の注文が完了するまでお待ちください。
No step of this route can take this order right now. …何も送信される前に、すべてのステップがスキップされました。テキストに各パネルとその理由が記載されます。
No step of this route accepted the order. …依頼したすべてのステップが拒否しました。請求はありません。
Too many requests…下記の上限を超えました。1分お待ちください。

例

cURL

curl https://smm.guide/api/v2 \
  -d key=sgo_… \
  -d action=add \
  -d service=85725095 \
  -d link=https://t.me/channel/123 \
  -d quantity=1000

PHP

function smmguide(array $post) {
  $ch = curl_init('https://smm.guide/api/v2');
  curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(
      ['key' => 'sgo_…'] + $post),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
  ]);
  $out = json_decode(curl_exec($ch), true);
  curl_close($ch);
  return $out;
}
$order = smmguide(['action' => 'add',
  'service' => 85725095,
  'link' => 'https://t.me/channel/123',
  'quantity' => 1000]);

リクエスト add には、常に30秒以内に応答します。ルートは複数のプロバイダーに順番に問い合わせることがあり、各プロバイダーには残りの時間が割り当てられます。待つ時間がないプロバイダーには問い合わせません。最後に問い合わせたプロバイダーが時間内に応答しない場合は、ステータスがPendingの注文番号が返され、応答が判明するまでルートはそこで停止します。ほとんどの注文は1~2秒で応答します。

上限と安全性

  • キーごとに1分あたり300リクエスト、うち注文は120件まで。 1回で最大100件の注文ID status の呼び出し。
  • キーは1回だけ表示され、フィンガープリントとして保存されます。 あなたも当サイトも、再び読み取ることはできません。再発行すると、古いキーは直ちに無効になります。
  • 許可するアドレス。 アカウントにパネルサーバーのアドレスを登録すると、キーは他の場所からは使えなくなります。
  • ルートIDは秘密情報ではなく、秘密にする必要もありません。 ルートを所有するアカウントのキーと組み合わせた場合にのみ機能します。
  • 上限は引き続き適用されます。 各パネルの1日の上限、ルート自体の1日の上限、1回の注文の上限は、手動の注文と同様にAPI経由の注文にも適用されます。
  • お金がsmm.guideを経由することはありません。 各注文は、注文を引き受けたパネル上の残高から支払われます。返金やトラブルは、あなたとそのパネルの間で解決していただきます。

カタログを読み取りたい場合は?

パネル、Trust Score、最新価格には専用のAPIと、アシスタント向けのMCPサーバーがあります。