登录

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

接口URL

http://api.kaolama.com/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://api.kaolama.com/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://api.kaolama.com/api/getPhone?sid=项目ID&token=登录返回token

请求方式

GET

请求Body参数

参数 示例值 必传 参数描述
sid 10041 必传 项目ID
token c17d216a5d9a4494951e195e3093071f 必传 登录成功返回的token
operatorChoice 0 非必传 获取指定运营商选项,0:不限运营商,1:包含运营商,2:不含运营商(默认值0)
operator 0 非必传 获取指定运营商选项,0:随机运营商,1:中国电信,2:中国移动,3:中国联通,4:虚拟运营商(默认值0)
areaChoice 0 非必传 获取指定省或市的号码,0:不限区域,1:包含区域,2:不含区域(默认值0)
areaType 0 非必传 获取指定省或市的号码,0:不筛选,1:按省份筛选,2:按城市筛选(默认值为0)
areaKeyword %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://api.kaolama.com/api/specified?sid=项目ID&phone=手机号码&token=登录返回token

请求方式

GET

请求Body参数

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

成功响应示例

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

失败响应示例

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

获取验证码

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

接口URL

http://api.kaolama.com/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://api.kaolama.com/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://api.kaolama.com/api/cancelRecv?sid=项目ID&phone=手机号码&token=登录返回token

请求方式

GET

请求Body参数

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

成功响应示例

0|释放成功

失败响应示例

1|错误信息