- 微信首次登录时需要先调用本接口创建设备,后续再次登录则直接使用之前创建的设备ID调用获取登录二维码接口登录即可。
- 同一个号避免频繁创建新设备登陆,容易触发风控
http://域名地址/api/login/createapp
POST
Content-Type:application/json
X-GEWE-TOKEN: 后台获取
参数名 | 必填 | 数据类型 | 说明 |
---|---|---|---|
regionid | 是 | string | 微信登陆地区ID,登录时请选择最近的地区,目前支持以下地区: 110000 北京市 120000 天津市 130000 河北省 140000 山西省 310000 上海市 320000 江苏省 330000 浙江省 340000 安徽省 350000 福建省 360000 江西省 370000 山东省 410000 河南省 420000 湖北省 430000 湖南省 440000 广东省 460000 海南省 500000 重庆市 510000 四川省 530000 云南省 610000 陕西省 |
参数名 | 数据类型 | 说明 |
---|---|---|
ret | number | 0:成功 |
msg | string | 反馈信息 |
data | object | |
appid | string | Appid相当于一台云设备 |
{
"regionid": "320000"
}
{
"ret": 0,
"msg": "success",
"data": {
"appid": "wx_nScLwnZhfNmlQlL0npc71"
}
}
{
"ret": 400,
"msg_err": "regionid不存在,请检查参数!"
}
http://域名地址/api/login/getloginqrcode
POST
Content-Type:application/json
X-GEWE-TOKEN: 后台获取
参数名 | 必填 | 数据类型 | 说明 |
---|---|---|---|
appid | 是 | string | 设备id,登录过的微信号,再次登录时传之前登录过的appid进行取码 |
regionid | 否 | string | 微信登陆地区ID,登录时请选择最近的地区,目前支持以下地区。默认使用上次登录地区: 110000 北京市 120000 天津市 130000 河北省 140000 山西省 310000 上海市 320000 江苏省 330000 浙江省 340000 安徽省 350000 福建省 360000 江西省 370000 山东省 410000 河南省 420000 湖北省 430000 湖南省 440000 广东省 460000 海南省 500000 重庆市 510000 四川省 530000 云南省 610000 陕西省 |
参数名 | 数据类型 | 说明 |
---|---|---|
ret | number | 0:成功 |
msg | string | 反馈信息 |
data | object | |
base64 | string | 二维码图片的base64 |
uuid | string | 取码接口返回的uuid |
nkey | string | 取码接口返回的nkey |
{
"appid": "wx_nScLwnZhfNmlQlL0npc71",
"regionid": "320000"
}
{
"ret": 0,
"msg": "success",
"data": {
"base64": "data:image/jpg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYID",
"uuid": "4fgut3ILSLNMtoxW2RUc",
"nkey": "httig9elPZ3SwZ3GWtdxzA=="
}
}
{
"ret": -1,
"msg": "fail",
"msg_err": "[wx_ECMY4oEDuQAP6impWwWv]设备不存在"
}
简要描述:
- 本接口需在取码后循环调用,每次调用间隔不低于5s,接口返回登陆微信的个人信息后即登录成功,登录成功后则不可继续调用本接口
http://域名地址/api/login/checkloginqrcode
POST
Content-Type:application/json
X-GEWE-TOKEN: 后台获取
参数名 | 必填 | 数据类型 | 说明 |
---|---|---|---|
appid | 是 | string | 设备id |
nkey | 是 | string | 取码接口返回的nkey |
uuid | 是 | string | 取码接口返回的uuid |
参数名 | 数据类型 | 说明 |
---|---|---|
ret | number | 0:成功 |
msg | string | 反馈信息 |
msg_err | string | 反馈错误信息 |
data | object | |
data.status_info.headImgUrl | string | 头像(在微信扫码后调本接口便会返回) |
data.status_info.nickName | string | 昵称(在微信扫码后调本接口便会返回) |
data.status_info.expiredTime | int | 二维码过期时间,单位秒,到期后不可继续调用本接口 |
data.login_info.acctSectResp.userName | string | 微信ID(登录成功后返回) |
data.login_info.acctSectResp.nickName | string | 昵称 |
data.login_info.acctSectResp.bindMobile | string | 绑定手机号 |
data.login_info.acctSectResp.alias | string | 微信号 |
{
"appid": "wx_nScLwnZhfNmlQlL0npc71",
"nkey": "httig9elPZ3SwZ3GWtdxzA",
"uuid": "4fgut3ILSLNMtoxW2RUc"
}
{
"ret": 0,
"msg": "success",
"data": {
"status_info": {
"uuid": "gf3ib31m1lV0Xufy3X_Y",
"status": 2,
"headImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/0AX8RNqDJiaNaSLSOGcLF0Z9VEMgBMwzGRDMCmCGBRwoiagjUVJqzVZyV94oGMcEmbrNf7u1tXVdgpdPaQ2kRJBpicgdVP4US93ULzGIbf6d4c/0",
"pushLoginUrlexpiredTime": 604200,
"nickName": "白开水加糖",
"expiredTime": 207
},
"login_info": {
"baseResponse": {
"ret": 0,
"errMsg": {
"string": "Everything is ok"
}
},
"unifyAuthSectFlag": 15,
"acctSectResp": {
"userName": "wxid_8pddddddddt22",
"nickName": "白开水加糖",
"bindUin": 0,
"bindMobile": "18114484426",
"alias": "xmry0601",
"status": 102949,
"pluginFlag": 162017,
"regType": 2,
"safeDevice": 0,
"officialUserName": "weixin",
"officialNickName": "微信团队",
"pushMailStatus": 0,
"fsurl": "https://w.mail.qq.com/cgi-bin/login?uin=0&key=e85900408448109MTY4ODYzNTQwOQ&keytype=2&target=setremind&from=weixin&vt=weixin&f=xhtml"
},
"axAuthSecRespList": {
"count": 0
}
}
}
}
{
"ret": 0,
"msg": "success",
"data": {
"status_info": {
"uuid": "gf3ib31m1lV0Xufy3X_Y",
"status": 2,
"headImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/0AX8RNqDJiaNaSLSOGcLF0Z9VEMgBMwzGRDMCmCGBRwoiagjUVJqzVZyV94oGMcEmbrNf7u1tXVdgpdPaQ2kRJBpicgdVP4US93ULzGIbf6d4c/0",
"pushLoginUrlexpiredTime": 604200,
"nickName": "白开水加糖",
"expiredTime": 207
},
"login_info": {
"baseResponse": {
"ret": 0,
"errMsg": {
"string": "Everything is ok"
}
},
"unifyAuthSectFlag": 15,
"acctSectResp": {
"userName": "wxid_8pddddddddt22",
"nickName": "白开水加糖",
"bindUin": 0,
"bindMobile": "18100002426",
"alias": "wxid_8pddddddddt22",
"status": 102949,
"pluginFlag": 162017,
"regType": 2,
"safeDevice": 0,
"officialUserName": "weixin",
"officialNickName": "微信团队",
"pushMailStatus": 0,
"fsurl": "https://w.mail.qq.com/cgi-bin/login?uin=0&key=e85900408448109MTY4ODYzNTQwOQ&keytype=2&target=setremind&from=weixin&vt=weixin&f=xhtml"
},
"axAuthSecRespList": {
"count": 0
}
}
}
}
{
"ret": -1,
"msg_err": "微信已登陆,请勿重复调用。"
}