NexaPanel API

API 对接文档

本页面公开访问，无需登录。创建密钥仍需进入客户控制台；接口兼容行业通用的 SMM POST 表单协议。

接口地址

https://app.nexa.ikunshop.top/api/v2

请求方法

POST

请求与返回

FORM / JSON

操作	说明
`services`	列出已启用服务、租户价格和能力。
`add`	创建订单。
`status`	查询单个或多个订单状态。
`refill`	为支持补单的订单创建单个或批量补单请求。
`refill_status`	查询单个或多个补单状态。
`cancel`	申请取消单个或多个符合条件的订单。
`balance`	查询钱包余额。

请求示例

curl -X POST 'https://app.nexa.ikunshop.top/api/v2' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=services'

密钥仅用于服务器端请求。每分钟默认最多 60 次请求；超过限制时返回 HTTP 429 和 Retry-After。

身份验证

每个请求都需要 key 和 action。

防止重复下单

调用 add 时固定传入唯一的 client_order_id。

错误返回

错误格式为 {"error":"CODE"}；批量请求会在对应项目内返回错误。

服务列表

返回当前租户已发布并启用的完整目录。refill 表示是否支持补单，refill_days 是供应商明确标注的质保天数；未标注时返回 null。

参数	说明
`key`	你的 API 密钥
`action`	固定为 services

返回示例

[
  {
    "service": "SERVICE_UUID",
    "name": "TikTok 优选粉丝",
    "type": "Default",
    "category": "TikTok 服务",
    "rate": "2.2724",
    "min": 10,
    "max": 1000000,
    "refill": true,
    "refill_days": 30,
    "cancel": true
  }
]

创建订单

service 使用服务列表返回的 UUID。client_order_id 由对接方生成并在重试时保持一致。

参数	说明
`key`	你的 API 密钥
`action`	固定为 add
`service`	服务 UUID
`link`	公开目标链接
`quantity`	下单数量，正整数
`client_order_id`可选	对接方唯一订单号

返回示例

{
  "order": "ORDER_UUID"
}

查询订单状态

传 order 查询单个订单；传 orders 查询最多 100 个订单，多个 UUID 使用英文逗号分隔。

参数	说明
`key`	你的 API 密钥
`action`	固定为 status
`order`可选	单个订单 UUID；与 orders 二选一
`orders`可选	多个订单 UUID，最多 100 个；与 order 二选一

返回示例

{
  "charge": "0.897",
  "start_count": 0,
  "status": "processing",
  "remains": 1000,
  "currency": "USD"
}

创建补单

补单期限由每项服务决定。SMMTurk 的 services 接口只返回是否支持补单，具体天数以供应商服务名称中的保障期为准；当前服务常见 30、60、90、365 天。

参数	说明
`key`	你的 API 密钥
`action`	固定为 refill
`order`可选	单个订单 UUID；与 orders 二选一
`orders`可选	多个订单 UUID，最多 100 个；与 order 二选一

返回示例

{
  "refill": "REFILL_REQUEST_UUID"
}

查询补单状态

补单请求会进入队列，由后台任务提交给实际供应商。

参数	说明
`key`	你的 API 密钥
`action`	固定为 refill_status
`refill`可选	单个补单请求 UUID；与 refills 二选一
`refills`可选	多个补单请求 UUID，最多 100 个

返回示例

{
  "status": "Completed"
}

申请取消

仅处于已提交或处理中的订单可申请取消，最终结果由供应商决定。

参数	说明
`key`	你的 API 密钥
`action`	固定为 cancel
`order`可选	单个订单 UUID；与 orders 二选一
`orders`可选	多个订单 UUID，最多 100 个

返回示例

{
  "order": "ORDER_UUID",
  "cancel": "CANCEL_REQUEST_UUID"
}

查询余额

参数	说明
`key`	你的 API 密钥
`action`	固定为 balance

返回示例

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

Loading workspace

NexaPanel API

API 对接文档

本页面公开访问，无需登录。创建密钥仍需进入客户控制台；接口兼容行业通用的 SMM POST 表单协议。

接口地址

https://app.nexa.ikunshop.top/api/v2

请求方法

POST

请求与返回

FORM / JSON

操作	说明
`services`	列出已启用服务、租户价格和能力。
`add`	创建订单。
`status`	查询单个或多个订单状态。
`refill`	为支持补单的订单创建单个或批量补单请求。
`refill_status`	查询单个或多个补单状态。
`cancel`	申请取消单个或多个符合条件的订单。
`balance`	查询钱包余额。

请求示例

curl -X POST 'https://app.nexa.ikunshop.top/api/v2' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=services'

密钥仅用于服务器端请求。每分钟默认最多 60 次请求；超过限制时返回 HTTP 429 和 Retry-After。

身份验证

每个请求都需要 key 和 action。

防止重复下单

调用 add 时固定传入唯一的 client_order_id。

错误返回

错误格式为 {"error":"CODE"}；批量请求会在对应项目内返回错误。

服务列表

返回当前租户已发布并启用的完整目录。refill 表示是否支持补单，refill_days 是供应商明确标注的质保天数；未标注时返回 null。

参数	说明
`key`	你的 API 密钥
`action`	固定为 services

返回示例

[
  {
    "service": "SERVICE_UUID",
    "name": "TikTok 优选粉丝",
    "type": "Default",
    "category": "TikTok 服务",
    "rate": "2.2724",
    "min": 10,
    "max": 1000000,
    "refill": true,
    "refill_days": 30,
    "cancel": true
  }
]

创建订单

service 使用服务列表返回的 UUID。client_order_id 由对接方生成并在重试时保持一致。

参数	说明
`key`	你的 API 密钥
`action`	固定为 add
`service`	服务 UUID
`link`	公开目标链接
`quantity`	下单数量，正整数
`client_order_id`可选	对接方唯一订单号

返回示例

{
  "order": "ORDER_UUID"
}

查询订单状态

传 order 查询单个订单；传 orders 查询最多 100 个订单，多个 UUID 使用英文逗号分隔。

参数	说明
`key`	你的 API 密钥
`action`	固定为 status
`order`可选	单个订单 UUID；与 orders 二选一
`orders`可选	多个订单 UUID，最多 100 个；与 order 二选一

返回示例

{
  "charge": "0.897",
  "start_count": 0,
  "status": "processing",
  "remains": 1000,
  "currency": "USD"
}

创建补单

补单期限由每项服务决定。SMMTurk 的 services 接口只返回是否支持补单，具体天数以供应商服务名称中的保障期为准；当前服务常见 30、60、90、365 天。

参数	说明
`key`	你的 API 密钥
`action`	固定为 refill
`order`可选	单个订单 UUID；与 orders 二选一
`orders`可选	多个订单 UUID，最多 100 个；与 order 二选一

返回示例

{
  "refill": "REFILL_REQUEST_UUID"
}

查询补单状态

补单请求会进入队列，由后台任务提交给实际供应商。

参数	说明
`key`	你的 API 密钥
`action`	固定为 refill_status
`refill`可选	单个补单请求 UUID；与 refills 二选一
`refills`可选	多个补单请求 UUID，最多 100 个

返回示例

{
  "status": "Completed"
}

申请取消

仅处于已提交或处理中的订单可申请取消，最终结果由供应商决定。

参数	说明
`key`	你的 API 密钥
`action`	固定为 cancel
`order`可选	单个订单 UUID；与 orders 二选一
`orders`可选	多个订单 UUID，最多 100 个

返回示例

{
  "order": "ORDER_UUID",
  "cancel": "CANCEL_REQUEST_UUID"
}

查询余额

参数	说明
`key`	你的 API 密钥
`action`	固定为 balance

返回示例

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