GeWe API|微信 API 开发文档
官方网站后台系统企业微信
官方网站后台系统企业微信
  1. 登录模块
  • 平台介绍
  • 快速开始 ⭐
  • Webhook
    • Webhook 事件 ⭐
    • 回调结构说明v1.0
    • 回调结构说明 v2.0
    • 调试指南⭐
    • 常见问题
  • API 参考
    • 登录模块
      • 获取登录二维码(步骤1)
        POST
      • 执行登录(步骤2)
        POST
      • 设置回调地址
        POST
      • 掉线重连
        POST
      • 弹框登录
        POST
      • AID 本地代理说明
        POST
    • 联系人模块
      • 获取通讯录列表
      • 获取通讯录列表缓存
      • 获取群/好友简要信息
      • 获取群/好友详细信息
      • 搜索好友
      • 添加联系人/同意添加好友
      • 删除好友
      • 设置好友仅聊天
      • 设置好友备注
      • 获取手机通讯录
      • 上传手机通讯录
      • 搜索企微
      • 添加企微好友
      • 同步企微好友
      • 获取企微好友详情
      • 检测好友关系
    • 群模块
      • 创建微信群
      • 修改群名称
      • 修改群备注
      • 修改我在群内的昵称
      • 邀请/添加 进群
      • 删除群成员
      • 退出群聊
      • 获取群信息
      • 获取群成员列表
      • 获取群成员详情
      • 获取群公告
      • 设置群公告
      • 同意进群
      • 添加群成员为好友
      • 获取群二维码
      • 群保存到通讯录
      • 管理员操作
      • 聊天置顶
      • 设置消息免打扰
      • 扫码进群
      • 确认进群申请
      • 解散群聊
    • 消息模块
      • 下载
        • 下载文件
        • 下载图片
        • 下载语音
        • 下载视频
        • 下载emoji
        • cdn下载
      • 发送文字消息
      • 发送文件消息
      • 发送图片消息
      • 发送语音消息
      • 发送视频消息
      • 发送链接消息
      • 发送名片消息
      • 发送emoji消息
      • 发送appmsg消息
      • 发送合并消息
      • 发送小程序消息
      • 发送定位
      • 转发文件
      • 转发图片
      • 转发视频
      • 转发链接
      • 转发小程序
      • 撤回消息
    • 朋友圈模块
      • 点赞/取消点赞
      • 删除朋友圈
      • 设置朋友圈可见范围
      • 是否允许陌生人查看朋友圈
      • 设置某条朋友圈为隐私/公开
      • 下载朋友圈视频
      • 发送文字朋友圈
      • 发送图片朋友圈
      • 发送视频朋友圈
      • 发送链接朋友圈
      • 上传朋友圈图片
      • 上传朋友圈视频
      • 转发朋友圈
      • 自己的朋友圈列表
      • 联系人的朋友圈列表
      • 某条朋友圈详情
      • 评论/删除评论
    • 标签模块
      • 添加标签
      • 删除标签
      • 标签列表
      • 修改好友标签
    • 个人模块
      • 获取个人资料
      • 获取自己的二维码
      • 获取设备记录
      • 隐私设置
      • 修改个人信息
      • 修改头像
    • 收藏夹模块
      • 同步收藏夹
      • 获取收藏夹内容
      • 删除收藏夹
    • 视频号模块
      • 关注
      • 评论
      • 浏览
      • 用户主页
      • 获取私信SessionId
      • 关注列表
      • 消息列表
      • 评论列表
      • 获取赞与收藏的视频列表
      • 搜索视频号
      • 创建视频号
      • 根据id点赞
      • 根据id点小红心
      • 获取我的视频号信息
      • 修改我的视频号信息
      • 发送视频号消息
      • 发送视频号朋友圈
      • 获取私信人信息
      • 发私信文本消息
      • 发私信图片消息
      • 扫码关注
      • 搜索并关注
      • 扫码浏览
      • 扫码评论
      • 扫码点赞
      • 扫码点小红心
      • 延迟点赞、小红心
      • 扫码登录视频号助手
      • 扫码获取视频详情
      • 我的视频号二维码
      • 上传CDN视频
      • 发布CDN视频
      • 发布视频-新
      • 同步私信消息
    • 账号管理
      • 账号密码登录
      • 检查是否在线
      • 退出
      • 设置代理
      • Mac转ipad接口
  • 账号与风控
    • 养号规范
    • 风险说明
    • 解封指南
  1. 登录模块

AID 本地代理说明

POST
Aid 本地代理
登录走你自己电脑、盒子或手机的网络出口。适合账号常用地和平台线路不一致,或要固定在门店、办公室、家里。工具由第三方提供。
三种方式拿到的都是 6 位 Aid 编号。填进 获取登录二维码的aid。从取码到扫码完成、账号在线期间,对应端的 Aid 不要关。
怎么选
三种方式流程相同,按你能长期开着的设备选一个即可。
Windows
首次测试、客服电脑、门店和家用电脑。解压即用,电脑开着才能在线。
Linux
长期在线、无人值守。用同城设备或盒子,不要优先用普通云服务器。
Android
手机流量或家里宽带当出口,或 Mac 登录要过滑块时用。
请求示例
三种方式填的字段相同。先拿到编号,再按这个 Body 取码。
Body
{
"appId": "",
"type": "ipad",
"aid": "703314"
}
aid 换成当前端显示的 6 位编号。填了 aid 后不用再选地区,regionId 和 proxyIp 都留空。只当出口时 type 用 ipad;Mac 登录还要过滑块时用 mac,并走 Android 二合一 App。
Windows
适合第一次测试,以及客服、门店、家里那台一直开着的电脑。64 位工具,解压就能用,不用安装。
1
下载并打开
下载压缩包,解压后打开主程序。本机防火墙若拦截,允许它出站访问 aid.nodemsg.com(443、1080)。
下载 Windows 64 位 Aid
2
等到 6 位编号
等待界面出现 6 位 Aid 编号,并显示就绪或隧道已建立。编号没出来前不要去取码。
3
填进请求
把编号填进 aid,按上面的请求示例调用 获取登录二维码。
4
扫码并保持运行
扫码登录。登录完成前不要退出程序;账号在线期间电脑也要开着,工具保持运行。
使用建议
电脑网络要在账号常用城市,或同城环境。不要用差很远的 VPN 出口。
登录过程中不要切换 Wi-Fi、VPN 或系统代理。
关掉休眠和自动关机。合盖、休眠、关机或退出工具后,Aid 会立刻离线。
这台电脑不能 24 小时开着时,改用 Linux。要用手机流量或过 Mac 滑块,改用 Android。
Linux
适合把一台长期在线的同城设备当成固定出口。可装在同城服务器、家用电脑、办公室小主机、虚拟机,或向客服买插电即用的盒子。不建议优先用普通云服务器:出口 IP 和常用地往往对不上,容易扫码异常或掉线。
1
确认环境
x86_64 或 arm64、带 systemd 的 Linux、root 或 sudo、能访问 https://aid.wkteam.cn。设备只要能出网,不需要公网 IP 或端口映射。
2
执行安装
已经是 root 时去掉 sudo。脚本会装好依赖并注册,不用手动配 token。
安装命令
curl -sSL https://aid.wkteam.cn/releases/linux/install.sh | sudo bash
3
取出 6 位编号
日志或本地后台都可以。也可以打开 http://设备IP:18080,默认账号 admin / 123456,第一次登录后立刻改密码。
从日志取编号
journalctl -u aidnet --no-pager | grep 'Aid 编号'
4
填进请求并保持运行
把编号填进 aid 并扫码。之后保持 aidnet 服务运行,不要删 /var/lib/aidnet(删了编号会变)。
使用建议
设备必须和账号常用地同城。云服务器只在同城、且你能接受风控风险时再用。
用网线,关掉休眠。盒子或小主机插上电和网即可长期跑。
更新直接再跑一遍安装命令,数据目录会保留,编号一般不变。
企业网若拦出站,放行 aid.nodemsg.com:443 和 aid.nodemsg.com:1080。
日常维护
systemctl status aidnet
systemctl restart aidnet
journalctl -u aidnet --no-pager -n 200
Android
适合用手机流量或家里宽带当登录出口,也适合 type 为 mac 时要过滑块。这是 Aid 出口 + Mac 滑块 二合一 App,装一台手机就够。
1
安装 App
用 Android 手机打开下载页并安装。系统拦截时,允许「未知来源」后再装。
下载 AID + Mac 滑块验证 App(Android)
2
等到 6 位编号
打开 App,等待界面出现 6 位 Aid 编号。把 App 加入电池白名单,不要进后台清理。
3
填进请求
把编号填进 aid,不用再填 regionId。只当出口用 ipad;还要过 Mac 滑块用 mac。
4
扫码并保持运行
扫码登录。完成前不要杀进程、不要切 Wi-Fi / 流量。出现滑块时,在这个 App 里完成。
使用建议
手机网络要在账号常用城市。家里宽带、门店 Wi-Fi、本机流量都可以,不要用差很远的热点。
登录过程中不要开关飞行模式,也不要在 4G 和 Wi-Fi 之间来回切。
国产手机默认会杀后台,请关闭该 App 的电池优化,并允许后台运行。
Android 不适合长期无人值守。要 7×24 在线,改用 Linux 或盒子。
排查
编号出不来、提示不可用或扫完就掉,先看这里。
看不到 Aid 编号
检查网络,重启工具,等显示就绪。Windows 看界面;Linux 执行 journalctl -u aidnet --no-pager -n 200;Android 把 App 拉回前台并检查流量。
登录提示 Aid 不可用
确认对应端还在运行,填的是当前界面上的 6 位,没有多复制空格。编号变了要用新的。
扫码后很快掉线
出口所在城市要接近账号常用地。登录后不要关 Aid:Windows 别休眠,Linux 别停服务,Android 别杀后台。
Linux 安装卡住或要 root
用带 sudo 的安装命令。下载失败时先执行 curl -I https://aid.wkteam.cn/releases/linux/install.sh 检查 HTTPS 和 DNS。
Mac 登录滑块过不去
改用 Android 二合一 App,取码时 type 为 mac。滑块必须在这个 App 里完成,不要换别的验证工具。

请求参数

无

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://api.geweapi.com'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2026-09-02 03:39:53
上一页
弹框登录
下一页
获取通讯录列表
Built with