短信接码 API 平台

0使用流程

• 向管理员获取 账号 / 密码（随机分配，含初始额度）。
• 推荐：直接用下面的「一键获取验证码」接口，一条链接自动完成 登录 → 取号 → 等待 → 返回验证码。
• 也可以分步调用：登录拿令牌 → 获取手机号（扣额度）→ 获取验证码，适合写脚本的开发者。

0一键取号 + 查验证码（推荐）

同一条链接两步用：第一次打开自动取号；在地址后加 &phone=手机号 再打开，直接返回该号码验证码

参数	必选	类型	说明
user	二选一	string	平台分配的用户名（与 token 二选一）
pass	二选一	string	平台分配的密码
token	二选一	string	已登录过时可直接传令牌，省去账号密码
sid	是	int	项目 ID
phone	第二步	int	取号返回后，在地址末尾加 &phone=手机号 再打开即查验证码
isp / province 等	否	-	取号可选参数，原样拼接即可

第一步 · 第一次打开（自动取号，扣额度）

{
  "code": 0,
  "msg": "取号成功，打开 next 链接查验证码",
  "phone": "16539834048",
  "sid": "23228",
  "next": "https://sms.ysyai.cloud/sms/?api=getCode&user=…&sid=23228&phone=16539834048"
}

第二步 · 地址后加 &phone=手机号 再打开（不扣额度，等待约 5~45 秒）

{
  "code": 0,
  "msg": "成功",
  "phone": "16539834048",
  "sid": "23228",
  "sms": "【撩技】您正在申请手机短信，验证码为：5184，1446分钟内有效！",
  "yzm": "5184"
}

• 第一步地址不要重复刷新（每次打开都会重新取号扣费）；查验证码阶段随便刷新，不扣费。
• 验证码未到时轮询等待约 45 秒，未收到会提示稍后重试，重新打开第二步地址即可继续等。
• 号码不要了请先用「释放号码」接口释放，再取新号。

1登录（获取 token 令牌）

令牌固定，除修改密码外不会变化，开发者登录只需请求一次

参数	必选	类型	说明
user	是	string	平台分配的用户名
pass	是	string	平台分配的密码

返回示例

{
  "msg": "success",
  "code": 0,
  "token": "2f805a475cc82f05a4cc82f05a475cc8"
}

• code=0 成功，code=-1 失败（msg 为中文原因，如密码错误 / 额度不足）。

2获取手机号

取号成功自动扣减额度；同一时间可取多个号码，用 uid 参数区分对应项目

参数	必选	类型	说明
token	是	string	登录获取的令牌
sid	是	int	项目 ID
isp	否	string	运营商：移动 / 联通 / 电信，需指定运营商时传汉字
province	否	string	省份代码，如 44=广东（见文末省份代码表）
asccription	否	int	专属码：1=simcloud，2=玛尔斯（专属专属卡）
paragraph	否	int	只取该段：填写号段
exclude	否	int	排除该段：填写号段
uid	否	string	开发者自定义，同时取多号时用于区分对应手机号
author	否	string	开发者标识（引入开发者返点分割）

返回示例

{
  "code": "0",
  "msg": "获取成功",
  "sid": 108,
  "uid": "108",
  "country_name": "中国",
  "country_code": "cn",
  "country_iso": "cn",
  "phone": "15814552141",
  "phone_iso": "+86"
}

3获取验证码

取号后调用本接口拉取短信内容，不扣额度

参数	必选	类型	说明
token	是	string	令牌
sid	是	int	项目 ID
phone	是	int	取号得到的号码

返回示例

{
  "code": "0",
  "msg": "成功",
  "sms": "【撩技】您正在申请手机短信，验证码为：5184，1446分钟内有效！",
  "yzm": "123456"
}

• yzm 为系统自动识别的数字验证码；code=0 成功，其他为失败（短信未到时轮询重试即可）。

4释放号码

号码不需要时及时释放，不扣额度；释放后该号码将不再收到本项目短信

释放指定号码

参数	必选	类型	说明
token	是	string	令牌
sid	是	int	项目 ID
phone	是	int	要释放的号码

释放全部号码

参数	必选	类型	说明
token	是	string	令牌

返回示例

{
  "code": "0",
  "data": null,
  "msg": "释放成功"
}

• 「一键获取验证码」超时未收到短信时，号码会保留，确认不再需要可用本接口释放。

5省份代码表

getPhone 的 province 参数可选值

展开查看全部省份代码

6备注

• 所有接口均为 GET 请求，把 URL 直接粘贴到浏览器即可看到 JSON 返回。
• 接口地址 /sms/?api=… 与主流接码平台格式一致，现有脚本只需把服务器地址换成上面地址即可。
• 号码取到后请及时释放与拉黑由上游规则处理；平台侧仅做鉴权、转发与额度结算。