伯乐接码 openAPI

请先仔细阅读以下内容

本平台无中国大陆号码 , 请在接入前确认 .
请专业技术人员阅读此文档 , 无技术基础不建议接入 , 技术客服不提供诸如 : 如何get , post ; 如何json解析等小白问题的技术支持 , 请谅解并尊重我们的时间成本

接口说明

接口域:https://admin.5188ma.com
接口统一编码: UTF8
接口调用方式: GET / POST方式
所有接口访问地址和参数,无需区分大小写

接口返回字段

字段名 说明
code 1成功,0失败
msg 消息标题
data 返回主数据
url (客户端直接忽略)
wait (客户端直接忽略)
count 分页时,数据总条数(分页时才有)

注:以下接口返回说明只针对 主数据data字段 进行解释 ,其余请参考以上表格说明

快速索引

用户登陆
获取项目列表
获取国家列表
获取手机号
获取短信内容
释放手机号
拉黑手机号
获取用户信息(包含余额)

用户登陆

请求模块:/userLogin/
请求方式:GET / POST
请求参数:

参数名 必传 描述
username Y 用户名
passwd Y 密码

GET 请求示例:
https://admin.5188ma.com/userLogin/?username=用户名&passwd=密码

返回示例:

失败:{"code":0,"msg":"密码必须由12-20位(大小写字母+数字)组成!","data":"","url":"","wait":3}
成功:{"code":1,"msg":"登陆成功!","data":{"token":"4t537y5yr85u093u73t3w","user":"一级退堂鼓表演艺术家","uid":2},"url":"","wait":3}

Data主数据解析:

字段名 描述
token 用户密钥,长期有效
uid 用户编号
user 用户昵称

获取项目列表

请求模块 :/getProList/
请求方式:GET / POST
请求参数:

参数名 必传 描述
token Y 用户密钥
type N 获取个人收藏时 传入值:mycollect
page N 页码
limit N 每页条数
keyword N 搜索项目关键词

GET 请求示例:
https://admin.5188ma.com/getProList/?token=登陆时返回的token

返回示例:

失败:{"code":0,"msg":"未查询到相关数据!","count":0,"data":[]}
成功:{"code":1,"msg":"获取成功!","count":2,"data":[{"id":261,"procode":"10019","icon":"\/static\/icon\/null.png","name":"twitter注册","ename":"Twitter reg","iscollect":"yes","price":"0.5","selectC":"yes"},{"id":222,"procode":"10069","icon":"\/static\/icon\/null.png","name":"Twitter 注册","ename":"Twitter login","iscollect":"yes","price":"0.5","selectC":"yes"}]}

Data主数据解析:

字段 描述
id 序号
procode 项目代码
icon 图标(相对地址)
name 项目名字
ename 英文名称
iscollect 是否已收藏
price 价格
selectC 是否需要选择国家(为no时,获取手机号接口domain直接传NOT)

获取国家列表

请求模块 :/getCountryList/
请求方式:GET / POST
请求参数:

参数名 必传 描述
page N 页码
limit N 每页条数
keyword N 搜索国家关键词

GET 请求示例:
https://admin.5188ma.com/getCountryList/

返回示例:

失败:{"code":0,"msg":"未查询到相关数据!","count":0,"data":[]}
成功:{"code":1,"msg":"获取成功!","count":1,"data":[{"id":37,"domain":"BD","ename":"Bangladesh","name":"孟加拉国","code":"+880"}]}

Data主数据解析:

字段 描述
id 序号
domain 国家简称
name 国家名字
ename 英文名称
code 电话区号

获取手机号

注:手机号有效期最长10分钟 ,获取下一个手机号最少间隔3秒钟(大客户可开放限制,请找客服洽谈)

请求模块 :/getNumber/
请求方式:GET / POST
请求参数:

参数名 必传 描述
token Y 用户密钥
procode Y 项目代码
domain Y 国家简称
operatorid N 运营商代号
number N 指定获取手机号(因项目而异)

GET 请求示例:
https://admin.5188ma.com/getNumber/?token=登陆时返回的token&procode=项目代码&domain=国家简称
返回示例:

失败:{"code":0,"msg":"您的账户余额不足,请及时充值!","data":"","url":"","wait":3}
成功:{"code":1,"msg":"获取成功","data":[{"id":"3","orderid":"20190124183943365140494","phoneNumber":"432465475"}],"url":"","wait":3}

Data主数据解析:

字段 描述
id 序号
orderid 订单编号
phoneNumber 电话号

获取短信内容

注:成功拿到手机号后,在有效期(600秒)之内 ,每5秒钟访问一次,直到获取短信成功 或者 600秒(超时)之后自动调取释放接口进行号码释放!

请求模块 :/getSmsContent/
请求方式:GET / POST
请求参数:

参数名 必传 描述
token Y 用户密钥
orderid Y (6)手机号码api的订单编号

GET 请求示例:
https://admin.5188ma.com/getSmsContent/?token=登陆时返回的token&orderid=手机号码api的订单编号
返回示例:

失败:{"code":0,"msg":"暂未查到内容!","data":"","url":"","wait":3}
成功:{"code":1,"msg":"获取成功","data":[{"orderid":"20190123105002365114667","messages":"你的 Twitter 确认码是 222139。","times":"2019-01-23 10:50:38"}],"url":"","wait":3}

Data主数据解析:

字段 描述
id 序号
orderid 订单编号
messages 短信内容
times 短信时间

释放手机号

请求模块 :/releaseNumber/
请求方式:GET / POST
请求参数:

参数名 必传 描述
token Y 用户密钥
orderid Y (6)手机号码api的订单编号

GET 请求示例:
https://admin.5188ma.com/releaseNumber/?token=登陆时返回的token&orderid=手机号码api的订单编号

返回示例:

失败:{"code":0,"msg":"释放失败!","data":"","url":"","wait":3}
成功:{"code":1,"msg":"拉黑成功!","data":"","url":"","wait":3}

拉黑手机号

请求模块 :/shieldNumber/
请求方式:GET / POST
请求参数:

参数名 必传 描述
token Y 用户密钥
orderid Y (6)手机号码api的订单编号

GET 请求示例:
https://admin.5188ma.com/shieldNumber/?token=登陆时返回的token&orderid=手机号码api的订单编号

返回示例:

失败:{"code":0,"msg":"反馈失败!","data":"","url":"","wait":3}
成功:{"code":1,"msg":"反馈成功!","data":"","url":"","wait":3}

获取用户信息

请求模块 :/index/user/getUserInfo/
请求方式:GET / POST
请求参数:

参数名 必传 描述
token Y 用户密钥

GET 请求示例:
https://admin.5188ma.com/index/user/getUserInfo/?token=登陆时返回的token

返回示例:

失败:{"code":0,"msg":"无用户数据!","data":"","url":"javascript:history.back(-1);","wait":3}
成功:{"code":1,"msg":"获取成功!","data":{"account":"wocao","name":"雾草","alipay":"2@2.com","tel":13000000000,"qq":123456,"email":"123@1.com","money":"9116.56"},"url":"","wait":3}

Data主数据解析:

字段 描述
account 用户账号
name 用户昵称
alipay alipay账号
tel 手机号码
qq qq号码
email 电子邮箱
money 用户余额