Orders API
smm.guideをプロバイダーとしてパネルに追加します。アカウントで作成した各ルートは、固有のIDを持つサービスになります。パネルがそのIDに注文を送ると、ルートは注文を引き受けられる最初のプロバイダーに注文を渡します。
3つのステップ
SMMパネル同士ですでに使われている形式なので、プログラミングは不要です。
https://smm.guide/api/v2 とキーを入力します。サービスをインポートすると、ルートがID、価格、数量の上下限とともに取り込まれます。リクエスト形式
| HTTPメソッド | POST |
| API URL | https://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キー |
action | services |
レスポンス
[
{
"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キー |
action | add |
service | ルートのID(8桁) |
link | ページ、投稿、プロフィールへのリンク |
quantity | 必要な数量 |
レスポンス
{
"order": 23501
}
受け付けたパネルがありません
{
"error": "No step of this route accepted the order. …"
}注文番号は、最終的にどのプロバイダーが配信しても、注文の全期間を通じて変わりません。ルートが受け付けるのはリンクと数量のみで、ドリップフィード、コメント、その他の追加フィールドは拒否されます。
注文ステータス
| パラメーター | 説明 |
|---|---|
key | あなたのAPIキー |
action | status |
order | 注文ID |
レスポンス
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| パラメーター | 説明 |
|---|---|
key | あなたのAPIキー |
action | status |
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キー |
action | balance |
レスポンス
{
"balance": "126.1375",
"currency": "USD"
}キャンセル
現在注文を保持しているプロバイダーに、そのサービスがキャンセルに対応していれば転送されます。キャンセルした注文が次のステップに送られることはありません。
| パラメーター | 説明 |
|---|---|
key | あなたのAPIキー |
action | cancel |
orders | カンマ区切りの注文ID(最大100件) |
レスポンス
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]リフィル
注文を配信したプロバイダーに転送されます。リフィルには注文自体の番号が付きます。
| パラメーター | 説明 |
|---|---|
key | あなたのAPIキー |
action | refill |
order | 注文ID。または orders:複数をカンマ区切りで指定 |
レスポンス(注文1件)
{ "refill": "23501" }
レスポンス(複数)
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| パラメーター | 説明 |
|---|---|
key | あなたのAPIキー |
action | refill_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サーバーがあります。