开发者文档

smmto.com API

通过强大的 REST API 将我们的服务直接集成到您的平台。快速、可靠且易于实现。立即打造您自己的增长工具或代理面板。

正常运行时间 99.9%
响应时间 <200ms
体量 50M+
获取 API 密钥 在 GitHub 上查看

1. 入门

我们的 API 基于 REST 原则构建。使用标准 HTTP 响应码、身份验证和动词。所有请求应发送到基础 URL，并以 JSON 格式返回响应。

基础 URL： https://smmto.com/api/v2

2. 身份验证

要验证请求，您必须在每个请求中将唯一的 API 密钥作为 `key` 参数包含。您可以在账户控制面板中找到 API 密钥。

POST https://smmto.com/api/v2
Content-Type: application/json

{
  "key": "your-api-key-here",
  "action": "services"
}

请保密您的 API 密钥。不要在公共仓库、客户端代码或文档中分享。如已泄露，请立即重新生成。

3. 添加订单

POST /api/v2

为我们平台上任何可用的社交媒体服务下新订单。

参数 类型 必填 描述
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

请求示例

{
  "key": "your-api-key",
  "action": "add",
  "service": 1,
  "link": "https://t.me/yourchannel",
  "quantity": 1000
}

响应示例

{
  "order": 23501,
  "status": "success"
}

4. 订单状态

POST /api/v2

查看先前下单的订单状态和进度。

参数 类型 必填 描述
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
 
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. 批量订单

POST /api/v2

效率至关重要。使用批量端点在一次 API 调用中下最多 100 个订单。

{
  "key": "your-api-key",
  "action": "add_bulk",
  "orders": [
    { "service": 1, "link": "link_1", "quantity": 100 },
    { "service": 2, "link": "link_2", "quantity": 250 }
  ]
}

6. Cancel Order

POST /api/v2

Cancel a pending or in-progress order by order ID.

{
  "key": "your-api-key",
  "action": "cancel",
  "order": 23501
}

7. Refill Order

POST /api/v2

Request a refill for eligible orders that dropped below the guaranteed level.

{
  "key": "your-api-key",
  "action": "refill",
  "order": 23501
}

8. Services List

POST /api/v2

Retrieve the full list of available services, rates, min/max quantities, and metadata.

{
  "key": "your-api-key",
  "action": "services"
}

9. 错误代码

API 使用标准 HTTP 状态码表示成功或失败。

代码 消息 描述
400Invalid requestMissing or invalid parameters
401Invalid API keyAuthentication failed
404Service not foundInvalid service ID
429Rate limit exceededToo many requests
500Internal errorServer-side error

10. Rate Limits

API requests are limited to 100 requests per minute per API key. Exceeding this limit returns HTTP 429. Contact support for higher throughput on reseller plans.

11. SDK 与库

12. Changelog

v2.0 — Unified REST endpoint at /api/v2 with bulk orders, refill status, and improved error responses.

面板 API 方法

Service list

POST /api/v2 services
参数 描述
key Your API key
action services

响应示例

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]

Add order

POST /api/v2 add

响应示例

{
    "order": 23501
}

Order status

POST /api/v2 status
参数 描述
key Your API key
action status
order Order ID

响应示例

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

Multiple orders status

POST /api/v2 multi_status
参数 描述
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

响应示例

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}

Create refill

POST /api/v2 refill
参数 描述
key Your API key
action refill
order Order ID

响应示例

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
参数 描述
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

响应示例

[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": 2
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]

Get refill status

POST /api/v2 refill_status
参数 描述
key Your API key
action refill_status
refill Refill ID

响应示例

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
参数 描述
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

响应示例

[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]

Create cancel

POST /api/v2 cancel
参数 描述
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

响应示例

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]

User balance

POST /api/v2 balance
参数 描述
key Your API key
action balance

响应示例

{
    "balance": "100.84292",
    "currency": "USD"
}
PHP 代码示例
在线客服 全天候支持