GEWE框架官网 geweapi.com 点击访问即可
创建新设备
简要描述：
- 微信首次登录时需要先调用本接口创建设备，后续再次登录则直接使用之前创建的设备ID调用获取登录二维码接口登录即可。
- 同一个号避免频繁创建新设备登陆，容易触发风控
请求URL：
-
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不存在，请检查参数！"
}获取登录二维码
请求URL：
-
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，接口返回登陆微信的个人信息后即登录成功，登录成功后则不可继续调用本接口
请求URL：
-
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": "微信已登陆，请勿重复调用。"
}-------------------------------------------------------------------------------------------------------------------------------
登录
创建新设备 获取登录二维码
执行登录 注销登录
消息
消息回调 消息撤回 发送app类型消息 发送小程序
发送CDN文件 发送CDN图片 发送CDN视频 发送emoji
发送文件 发送图片 发送链接 发送消息 发送视频 发送语音
朋友圈
评论点赞 朋友圈功能操作 隐私设置 内容详情 查看自己朋友圈时间线
发布朋友圈 上传图片 上传视频 联系人朋友圈首页
个人
删除已登录设备 获取个人信息 获取个人二维码
获取已登录设备 隐私设置 更新个人资料 上传头像
联系人
联系人/群列表 批量获取联系人简要信息
联系人关系检测 删除联系人 联系人资料 获取手机通讯录 搜索
设置联系人免打扰 设置联系人备注 上传手机通讯录 好友请求验证
收藏与标签
删除收藏内容 获取收藏内容 获取收藏信息
同步收藏 添加标签 删除标签 标签列表 修改标签 修改标签名
群组
管理员操作 邀请进群申请确认 创建群组 删除群组成员 获取群组详情
解散群组 获取群组二维码 扫码进群 同意进群组 获取群组信息详情
邀请或添加联系人进群 获取群组成员信息 保存到通讯录
一键添加群组联系人 查询群成员信息 设置群组公告 设置群组免打扰
设置我所在群组的昵称 设置群组名称 设置群组备注 群待办 群组聊天置顶
其他
Emoji下载
语音下载
资源下载
3768
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
