API 对接使用说明

本文档介绍如何通过疾驰短信用户 API 完成项目查询、取号、验证码获取及号码释放。所有接口均需在 Header 中提供 fcToken 进行鉴权。

请在用户后台的“我的 Token”页面生成并妥善保存 Token。

基础说明： 鉴权参数：fcToken（Header 必填）调用频率：建议每分钟不超过 60 次，异常请求可能触发临时限制返回结构统一为：{ code: 1|0, msg: string, data?: any }

1）获取项目列表

GET/api/user/projects

支持按项目名称过滤，支持按项目名称搜索。

参数	位置	必填	说明	示例
fcToken	Header	必填	用户 Token	abcdef123456...
project_name	Query	可选	按名称搜索	抖音
page	Query	可选	页码，默认 1	1
pagesize	Query	可选	每页数量，默认 100，最大 200	100

# cURL 示例
curl -X GET "https://www.jichisms.com/api/user/projects?project_name=抖音&page=1&pagesize=100" \
  -H "fcToken: your_token_here"

# 返回示例
{ "code": 1, "msg": "成功", "data": [{ "id": 123, "project_name": "抖音", "money": "0.99" }] }

2）获取手机号（官方引擎）

POST/api/user/getPhone

取号成功后自动扣费。

参数	位置	必填	说明	示例
fcToken	Header	必填	用户 Token	abcdef123456...
project_id	Body	必填	项目 ID	123
phone	Body	可选	指定手机号（一次接码）	13800138000
isp	Body	可选	运营商筛选	移动
province	Body	可选	省份筛选	广东
paragraph	Body	可选	号段筛选（前 3 位）	138
ascription	Body	可选	卡号类型：1=移动 2=联通	1

# cURL 示例
curl -X POST "https://www.jichisms.com/api/user/getPhone" \
  -H "fcToken: your_token_here" -d "project_id=123"

# 返回示例
{ "code": 1, "msg": "成功", "data": [{ "phone": "13800138000", "sp": "移动", "phone_gsd": "广东 广州" }] }

3）获取验证码

POST/api/user/getVerifyCode

读取已获取号码的短信验证码，获取成功后自动扣费。phone 参数必须使用“获取手机号”接口返回的号码。

⏱ 调用频率限制：同一手机号每 5 秒最多查询一次，请在脚本中加入延时逻辑。

参数	位置	必填	说明	示例
fcToken	Header	必填	用户 Token	abcdef123456...
project_id	Body	必填	项目 ID	123
phone	Body	必填	通过 getPhone 获取到的手机号	13800138000

# cURL 示例
curl -X POST "https://www.jichisms.com/api/user/getVerifyCode" \
  -H "fcToken: your_token_here" -d "project_id=123&phone=13800138000"

# 返回示例
{ "code": 1, "msg": "123456", "data": null }

4）释放号码（官方引擎）

POST/api/user/releasePhone

释放已获取的手机号，支持官方引擎和卡商引擎项目。

参数	位置	必填	说明	示例
fcToken	Header	必填	用户 Token	abcdef123456...
project_id	Body	必填	项目 ID	123
phone	Body	必填	要释放的手机号	13800138000

# cURL 示例
curl -X POST "https://www.jichisms.com/api/user/releasePhone" \
  -H "fcToken: your_token_here" -d "project_id=123&phone=13800138000"

# 返回示例
{ "code": 1, "msg": "释放成功" }

5）卡商引擎取号

POST/api/user/getCardEnginePhone

需先查询对接码列表选择卡商，取号成功后自动扣费。

提示：取号失败时，请更换其他卡商重试。

参数	位置	必填	说明	示例
fcToken	Header	必填	用户 Token	abcdef123456...
project_id	Body	必填	卡商引擎项目 ID	456
code_id	Body	必填	对接码 ID	562829
phone	Body	可选	指定手机号（11 位数字）	13800138000
hd	Body	可选	指定号段（前 3 位数字）	138
ascription	Body	可选	卡号类型：1=移动 2=联通	1

# cURL 示例
curl -X POST "https://www.jichisms.com/api/user/getCardEnginePhone" \
  -H "fcToken: your_token_here" -d "project_id=456&code_id=562829"

# 返回示例
{ "code": 1, "msg": "获取成功", "data": { "phone": "13800138000" } }

6）查询对接码列表（卡商引擎）

GET/api/index/getCodeStoreByProjectId

查询指定卡商引擎项目下的可用对接码列表，获取 code_id 用于取号。

参数	位置	必填	说明	示例
project_id	Query	必填	卡商引擎项目 ID	456
page	Query	可选	页码，默认 1	1
limit	Query	可选	每页数量，默认 20，最大 100	20

# cURL 示例
curl -X GET "https://www.jichisms.com/api/index/getCodeStoreByProjectId?project_id=456" \
  -H "fcToken: your_token_here"

# 返回示例
{ "code": 200, "data": { "list": [{ "code_id": 562829, "project_name": "示例项目", "available_number": 208 }], "total": 50 } }