首页 / 开发者 / Orders API

Orders API

在您的面板中将 smm.guide 添加为供应商。您在账户中创建的每个路由都是一项有独立 ID 的服务:您的面板将订单发送到该 ID,路由再将其传给您的供应商中第一个能够接单的。

三个步骤

该格式正是 SMM 面板之间已在使用的格式,因此无需任何编程。

1创建路由在“账户”中依次打开 Orders desk 和“路由”。选择它提供的服务,并从您已连接的面板中添加最多五项同类服务。
2创建密钥在 Orders desk 中打开 Orders API。密钥只显示一次。您可以将其限制为仅允许您面板服务器的地址使用。
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,八位数字
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 表示未交付的部分。它统计所有步骤的交付量:当一个步骤交付了一部分、剩余部分在下一个步骤被取消时,订单状态为 Partial,而非 Canceled。剩余费用是否退还由供应商决定。
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:多个 ID,用逗号分隔

响应(单个订单)

{ "refill": "23501" }

响应(多个订单)

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
参数说明
key您的 API 密钥
actionrefill_status
refill补量 ID。或使用 refills:多个 ID,用逗号分隔

响应

{ "status": "Completed" }

路由如何处理订单

  • 步骤按您设定的顺序尝试,或优先尝试最便宜的可用步骤。 具体方式在路由中选择。
  • 以下情况会跳过某个步骤: 其面板未响应;余额或每日限额不足以支付订单;数量超出其接受范围;价格高于您设定的上限;或按其价格计算,订单会超出路由自身的每日限额。跳过的步骤会自动恢复。
  • 以下情况步骤会被停用: 其服务从价目表中下架,或面板开始以同一 ID 出售其他服务。其他步骤继续工作,并会通知您。
  • 被拒绝时,订单会转往下一个步骤。 面板响应并拒绝时,不会产生任何扣费,因此会尝试下一个步骤。
  • 未得到明确答复时,路由会停止。 超时或响应异常无法说明订单是否存在。继续转发可能导致重复交付和重复扣费,因此路由会停止,由您在账户中核实这一订单。
  • 每个链接只能有一个进行中的订单。 某个链接的订单在路由上运行期间,同一链接的第二个订单会被拒绝,供应商自身也是这样处理的。
  • 交付前的取消也可以转往下一个步骤, 前提是您开启了该选项。部分完成订单中未交付的部分,只有在您要求时才会转往下一个步骤。

错误

错误含义
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…超出下方限制。请等待一分钟。

示例

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 的订单号,路由会停在此处,直到得知答复。大多数订单在一两秒内就会得到响应。

限制与安全

  • 每个密钥每分钟 300 次请求,其中下单请求 120 次。 单次请求最多 100 个订单 ID: status 调用。
  • 密钥只显示一次,并以指纹形式保存。 您和我们都无法再次读取它。替换后旧密钥立即失效。
  • 允许的地址。 在您的账户中填写您面板服务器的地址,密钥便无法在其他任何地方使用。
  • 路由 ID 不是机密,也无需保密。 它只有与拥有该路由的账户的密钥一起使用才有效。
  • 您的限额依然有效。 每个面板的每日限额、路由自身的每日限额及其单笔订单上限,对通过 API 下的订单与手动下的订单同样适用。
  • 资金从不经过 smm.guide。 每笔订单都从您在接单面板上的余额中支付。退款和争议由您与该面板之间处理。

需要读取目录?

面板、Trust Score 和实时价格有独立的 API,以及面向 AI 助手的 MCP 服务器。