登录

[注]请求地址为login,区分大小写
[注]所有请求与返回都为UTF-8,不再支持GBK
[注]成功:0|token,失败:1|错误原因
不改密码token永久有效,无需重复获取
非必传参数无需传入,不传入则为默认值

接口URL

http://103.91.211.231/api/login?userName=用户名&password=密码

请求方式

GET

请求Body参数

参数 示例值 必传 参数描述
userName a123456 必传 用户名
password 000000 必传 密码

成功响应示例

0|token
示例:0|登录成功|c17d216a5d9a4494951e195e3093071f
注:后面所有接口都要用到token

失败响应示例

1|错误信息
示例:1|密码错误

查询余额

[注]请求地址为getSummary,区分大小写
[注]所有请求与返回都为UTF-8,不再支持GBK
返回0|为成功,返回1|为失败或错误
非必传参数无需传入,不传入则为默认值

接口URL

http://103.91.211.231/api/getSummary?token=登录返回token

请求方式

GET

请求Body参数

参数 示例值 必传 参数描述
token c17d216a5d9a4494951e195e3093071f 必传 登录成功返回的token

成功响应示例

0|余额|积分|最大获取数量
示例:0|20.00|30|20

失败响应示例

0|错误信息
示例:1|登录失效,请重新登录

获取号码

[注]请求地址为getPhone,区分大小写
[注]所有请求与返回都为UTF-8,不再支持GBK
[注]并发过高有可能禁闭IP
返回0|为成功,返回1|为失败或错误
非必传参数无需传入,不传入则为默认值

接口URL

http://103.91.211.231/api/getPhone?sid=项目ID&token=登录返回token

请求方式

GET

请求Body参数

参数 示例值 必传 参数描述
sid 10041 必传 项目ID
token c17d216a5d9a4494951e195e3093071f 必传 登录成功返回的token
operator unlimit 非必传 获取指定运营商选项,可选值为 "unlimit"(不限运营商),"includeX"(只取某运营商),"excludeX"(不取某运营商),includeX和excludeX中"X"为运营商代码(1:中国电信,2:中国移动,3:中国联通,4:虚拟运营商),示例:exclude4为不取虚拟运营商
locationMatching unlimit 非必传 获取指定省或市的号码,unlimit:不限区域,include:包含区域,exclude:不含区域(默认值unlimit)
locationLevel unlimit 非必传 获取指定省或市的号码,p:省份,c:城市
location %E6%B5%99%E6%B1%9F 非必传 获取指定省或市的号码,省份/城市名称 URL编码(UTF-8)
developer a123456 非必传 开发者用户名,空则没有开发者提成。(默认值为空)

成功响应示例

0|手机号|运营商|省份|城市
示例:0|13000000000|中国移动|山东|济南

失败响应示例

1|错误信息
示例:1|暂时没有可用号码

获取指定号码

[注]请求地址为specified,区分大小写
[注]所有请求与返回都为UTF-8,不再支持GBK
返回0|为成功,返回1|为失败或错误
非必传参数无需传入,不传入则为默认值
返回0|后系统自动释放,以后不会再取到,无需再次加黑或释放,频繁重复调用可能导致账号被锁定
相同手机号至少5秒请求一次,请求频繁可能导致账号被锁定

接口URL

http://103.91.211.231/api/specified?sid=项目ID&phone=手机号码&token=登录返回token

请求方式

GET

请求Body参数

参数 示例值 必传 参数描述
sid 10041 必传 项目ID
phone 13000000000 必传 指定手机号
token c17d216a5d9a4494951e195e3093071f 必传 登录成功返回的token
developer a123456 非必传 开发者用户名,空则没有开发者提成。(默认值为空)

成功响应示例

0|手机号|运营商|省份|城市|反馈pid
示例:0|13000000000|中国移动|山东|济南|4646313

失败响应示例

1|错误信息
示例:1|号码已离线

获取验证码

[注]请求地址为getMessage,区分大小写
[注]所有请求与返回都为UTF-8,不再支持GBK
返回0|为成功,返回1|为失败或错误
非必传参数无需传入,不传入则为默认值
返回0|后系统自动释放,以后不会再取到,无需再次加黑或释放,频繁重复调用可能导致账号被锁定
相同手机号至少5秒请求一次,请求频繁可能导致账号被锁定

接口URL

http://103.91.211.231/api/getMessage?sid=项目ID&phone=手机号码&token=登录返回token

请求方式

GET

请求Body参数

参数 示例值 必传 参数描述
sid 10041 必传 项目ID
phone 13000000000 必传 获取验证码的手机号
token c17d216a5d9a4494951e195e3093071f 必传 登录成功返回的token

成功响应示例

0|短信内容|短信验证码
示例:0|您的验证码是123456|123456

失败响应示例

1|错误信息
示例:1|接码超时

加黑号码

[注]请求地址为addBlacklist,区分大小写
[注]所有请求与返回都为UTF-8,不再支持GBK
返回0|为成功,返回1|为失败或错误
非必传参数无需传入,不传入则为默认值
只有验证码超时或不能使用才需要加黑,收到验证码系统会自动加黑,不会再被任何用户获取到

接口URL

http://103.91.211.231/api/addBlacklist?sid=项目ID&phone=手机号码&token=登录返回token

请求方式

GET

请求Body参数

参数 示例值 必传 参数描述
sid 10041 必传 项目ID
phone 13000000000 必传 要加黑的手机号
token c17d216a5d9a4494951e195e3093071f 必传 登录成功返回的token

成功响应示例

0|加黑成功

失败响应示例

1|错误信息

释放号码

[注]请求地址为cancelRecv,区分大小写
[注]所有请求与返回都为UTF-8,不再支持GBK
返回0|为成功,返回1|为失败或错误
非必传参数无需传入,不传入则为默认值
没有使用的手机号请释放处理,如果不释放,可能造成同时取号数量满额

接口URL

http://103.91.211.231/api/cancelRecv?sid=项目ID&phone=手机号码&token=登录返回token

请求方式

GET

请求Body参数

参数 示例值 必传 参数描述
sid 10041 必传 项目ID
phone 13000000000 非必传 要释放的手机号,若参数为空则释放账号占用的所有号码
token c17d216a5d9a4494951e195e3093071f 必传 登录成功返回的token

成功响应示例

0|释放成功

失败响应示例

1|错误信息

API反馈

[注]请求地址为return,区分大小写
[注]所有请求与返回都为UTF-8,不再支持GBK
[注]成功:0|反馈成功,失败:1|错误原因
非必传参数无需传入,不传入则为默认值

接口URL

http://103.91.211.231/api/return?token=登录返回token&pid=取号返回的pid&remark=反馈信息

请求方式

GET

请求Body参数

参数 示例值 必传 参数描述
token c17d216a5d9a4494951e195e3093071f 必传 登录成功返回的token
pid 22454120 必传 取号返回的pid
remark %E5%8F%B7%E7%A0%81%E8%A2%AB%E4%BD%BF%E7%94%A8 必传 反馈信息 URL编码(UTF-8)。(默认值为空)

成功响应示例

0|反馈成功
示例:0|反馈成功
                        

失败响应示例

1|错误信息
示例:1|pid因超时释放已失效