把实时服务目录和下单能力接入你的产品。

在账户页创建密钥。密钥只完整显示一次，请把它保存在服务端环境变量中，不要放进浏览器代码或公开仓库。

可使用 Bearer 请求头，也可在表单或 JSON 中传入 key。推荐 Bearer。

Authorization: Bearer smr_live_your_key
Content-Type: application/json

返回当前上架服务、我们的每 1,000 单位售价、数量范围以及 refill/cancel 能力。公开 service 编号属于 SMM Route，不包含上游编号。

curl -X POST https://smmroute.com/api/v2 \
  -H "Authorization: Bearer $SMMROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"services"}'

返回账户当前可用美元余额。API 与网页使用同一个余额账本。

{"action":"balance"}

→ {"balance":"25.40","currency":"USD"}

使用 services 返回的 service、公开目标链接和允许的整数数量创建订单。request_id 为可选 UUID；重试请求时复用它，可避免重复扣款。

{
  "action": "add",
  "service": "svc_public_service_id",
  "link": "https://example.com/public-content",
  "quantity": 1000,
  "request_id": "65ac38db-ffb4-4fcc-95e8-6f85faec62ae"
}

→ {"order":"order_uuid"}

使用 SMM Route 返回的 order 查询状态。可能状态为 Pending、In progress、Completed、Partial 或 Canceled。Partial 时未交付部分会自动退回余额。

{"action":"status","order":"order_uuid"}

→ {
  "order": "order_uuid",
  "charge": "3.24",
  "status": "In progress",
  "remains": 420,
  "currency": "USD"
}

CLI 支持一次性命令、交互模式和 JSON 输出，适合运维脚本与自动化测试。

python -m pip install ./smmroute-cli.zip
smmroute configure --key "$SMMROUTE_API_KEY"
smmroute services --platform Instagram --family Followers
smmroute balance
smmroute order create --service svc_id --link https://example.com/post --quantity 1000
smmroute order status ORDER_ID --json

HTTP 4xx 表示请求、身份验证、余额或数量问题；HTTP 5xx 表示暂时不可用。错误响应始终包含 error，部分响应还包含稳定的 code。