KUIKUI
仪表盘
接码服务
接码服务历史记录
卡密服务
卡密商城卡密订单
软件服务
软件下载
资金
充值提现交易明细
邀请返利设置

API文档

使用开放API自动化接码服务

认证方式

所有请求需在 Header 中携带 API Key:

Authorization: Bearer YOUR_API_KEY
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://smskuikui.top/api/open/balance

请在「个人设置」中获取和管理您的 API Key

响应格式
{
  "code": 0,
  "message": "success",
  "data": { ... }
}

接口列表

GET/api/open/balance

查询账户余额

Response data

{
  "balance": "28.5000",
  "frozenBalance": "2.5000",
  "usdtBalance": "0.0000",
  "usdtFrozenBalance": "0.0000"
}
GET/api/open/countries

获取可用国家列表

Response data

{
  "countries": [
    { "code": "1", "name": "美国", "nameEn": "United States" }
  ]
}
GET/api/open/services?country=1

获取某国家的服务列表和价格

Response data

{
  "services": [
    { "code": "tg", "name": "Telegram", "price": "2.5000", "available": 156 }
  ]
}
POST/api/open/number/get

申请虚拟号码

Request

{
  "country": "1",
  "service": "tg",
  "operator": "virtual",
  "currency": "CNY"
}

Response data

{
  "activationId": "cmabc123",
  "phoneNumber": "+1234567890",
  "serviceName": "Telegram",
  "countryName": "美国",
  "provider": "hero_sms",
  "operator": "virtual",
  "price": "2.5000",
  "currency": "CNY",
  "status": "WAITING",
  "code": null,
  "expiresAt": "2026-04-30T12:00:00.000Z"
}
GET/api/open/number/status?id=cmabc123

查询验证码状态

Response data

{
  "activationId": "cmabc123",
  "phoneNumber": "+1234567890",
  "status": "COMPLETED",
  "code": "583921",
  "smsCode": "583921",
  "expiresAt": "2026-04-30T12:00:00.000Z"
}
POST/api/open/number/complete

完成激活

Request

{ "id": "cmabc123" }

Response data

{ "id": "cmabc123", "status": "COMPLETED" }
POST/api/open/number/cancel

取消激活(退款)

Request

{ "id": "cmabc123" }

Response data

{
  "id": "cmabc123",
  "status": "CANCELLED",
  "refunded": "2.5000"
}
GET/api/open/activations?page=1&pageSize=20&status=COMPLETED

查询接码订单列表

Response data

{
  "items": [
    {
      "activationId": "cmabc123",
      "phoneNumber": "+1234567890",
      "serviceName": "Telegram",
      "countryName": "美国",
      "price": "2.5000",
      "status": "COMPLETED",
      "code": "583921",
      "createdAt": "2026-04-30T11:50:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1
}