微信 API 可视化控制台
前往后台 前往api文档
Token
appId 未设置 微信昵称 —

个人信息管理

请求经 core-gw.js 的 apiPost 发出，效果等同 axios：自动带 VideosApi-token，并在 body 中合并全局 appId。

我的二维码

POST /personal/getQrCode，与文档一致 body 可带 proxyIp（空串即可）；返回 data.qrCode 为图片 Base64。

设备记录

POST /personal/getSafetyInfo，返回 data.list：设备名称、类型、最后操作时间等。

隐私设置

POST /personal/privacySettings：option 为选项编号， open 为是否开启，useProxy 为是否走代理（见文档）。

open
useProxy

修改个人资料

对应 POST /personal/updateProfile；性别提交为数字 1 男 / 2 女。

修改头像

注意：修改头像成功后，请将手机微信进程完全关闭并重新打开，才能看到最新头像（见接口文档说明）。

useProxy

当前资料预览

请先点击「获取个人资料」
接口响应日志（原始 JSON）

获取通讯录列表（包含群聊）

POST /contacts/fetchContactsList。根据好友数量可能较久；若超时可用下方「缓存」接口。返回 data.friends（好友 wxid）、data.chatrooms（已保存到通讯录的群）、data.ghs（公众号）。

获取通讯录列表（缓存）

POST /contacts/fetchContactsListCache。列表缓存约 10 分钟；无缓存或过期后需重新调用「获取通讯录列表」。

搜索好友

POST /contacts/search。参数 contactsInfo：微信号、手机号等。若已是好友，返回的 v3 可能为好友 wxid；可在下方「添加好友」中按需自行填写 v3、v4（搜索不会自动填入）。

添加好友 / 同意好友

POST /contacts/addContacts。scene 为添加来源（如 3 微信号搜索、15 手机号）；option：2 添加好友、3 同意、4 拒绝。v3、v4 来自搜索或回调；content 为招呼语。

删除好友

POST /contacts/deleteFriend。参数 wxid：要删除的好友 wxid。

获取群 / 好友简要信息

POST /contacts/getBriefInfo。参数 wxids 为数组；本页填写一个 wxid 即请求 [wxid]。

获取群 / 好友详细信息

POST /contacts/getDetailInfo。参数 wxids 为数组；本页填写一个 wxid 即请求 [wxid]。返回字段比简要信息更全（如朋友圈背景等）。

设置好友仅聊天

POST /contacts/setFriendPermissions。参数 wxid、onlyChat（是否仅聊天）。若手机展示未更新，可重新进入页面刷新。

设置好友备注

POST /contacts/setFriendRemark。参数 wxid、remark。

通讯录数据

三个 Tab 分别只展示一类：好友、群聊、公众号（默认打开好友）。拉取通讯录成功后，会自动按每批 20 个调用 POST /contacts/getDetailInfo 补全展示：优先显示备注，无备注则显示昵称/群名/公众号名（nickName），下方灰字为 wxid 或群 ID。误出现在 ID 以 @chatroom 结尾的归群聊，以 gh 开头（不区分大小写）的归公众号，其余归好友。

接口响应（按调用顺序追加，每条标注路径）

消息发送与 CDN 下载

所有请求经 apiPost 自动带 Token 与 appId。发送类接口共用下方「接收人 toWxid」，与联系人模块锁定的 currentTargetWxid 联动。

打开本页或点击「同步目标」时，会从 state.currentTargetWxid 与本地存储写入此框。

POST /message/postText。群内 @ 需在 content 中含 @；可选 ats（英文逗号分隔，@全部填 notify@all）。

CDN 下载 — POST /message/downloadCdn

与发送接口独立，无需 toWxid。参数与文档一致：type 1–5； totalSize、suffix 按接口要求填写。

接口执行结果

朋友圈（SNS）

与《朋友圈模块.md》一致，共 17 个 POST /sns/*；下方按 Tab 分组展示，顶部为完整目录。请求经 apiPost 自动带 Token 与 appId。

朋友圈模块接口目录（17）
  1. /sns/likeSns — 点赞 / 取消点赞
  2. /sns/delSns — 删除朋友圈
  3. /sns/snsVisibleScope — 设置朋友圈可见范围
  4. /sns/strangerVisibilityEnabled — 是否允许陌生人查看
  5. /sns/snsSetPrivacy — 单条设为隐私/公开
  6. /sns/downloadSnsVideo — 下载朋友圈视频
  7. /sns/sendTextSns — 发文字
  8. /sns/sendImgSns — 发图文（需先上传图片）
  9. /sns/sendVideoSns — 发视频（需先上传视频）
  10. /sns/sendUrlSns — 发链接卡片
  11. /sns/uploadSnsImage — 上传朋友圈图片
  12. /sns/uploadSnsVideo — 上传朋友圈视频
  13. /sns/forwardSns — 转发朋友圈
  14. /sns/snsList — 朋友圈信息流 / 翻页
  15. /sns/contactsSnsList — 指定好友朋友圈
  16. /sns/snsDetails — 单条详情
  17. /sns/commentSns — 评论 / 删评论

朋友圈大厅（snsList）

首请求 firstPageMd5: ""、maxId: 0；翻页使用上次返回的 firstPageMd5 与 maxId。

当前游标：未加载

查看指定好友朋友圈（contactsSnsList）

打开本页时会填入 state.currentTargetWxid。

当前游标：未加载

单条详情 POST /sns/snsDetails

朋友圈动态

接口原始响应（JSON）

标签管理

《标签模块.md》共 4 个接口：/label/list、/label/add、/label/delete、/label/modifyMemberList。请求走 apiPost。

接口目录
  1. POST /label/list — 标签列表
  2. POST /label/add — 添加标签
  3. POST /label/delete — 删除标签
  4. POST /label/modifyMemberList — 修改好友标签（全量）

标签库

修改好友标签 /label/modifyMemberList

文档要求全量 labelIds。wxIds 支持英文逗号多个；默认带通讯录锁定目标。

标签列表

接口原始响应

收藏夹

《收藏夹模块.md》共 3 个接口：/favor/sync、/favor/getContent、/favor/delete。

接口目录
  1. POST /favor/sync — 同步（翻页 syncKey）
  2. POST /favor/getContent — 获取内容
  3. POST /favor/delete — 删除记录

同步

首次 syncKey: ""；下一页带上次返回的 syncKey。

当前 syncKey：（未同步）

按 favId 操作

收藏预览

flag=1 表示记录已删除（文档说明）。「发送给当前目标」会先拉详情再发文字消息。

接口原始响应

消息推送解析（Webhook Logs）

依据仓库内《消息推送内容.txt》规则解析 TypeName、AddMsg 群聊 Content.string 首段发件人等。下方终端可通过「模拟接收推送」或全局函数 handlePushMessage(jsonStr) 追加日志。

Webhook 地址配置

本平台无法代您注册公网回调；此处仅保存「您服务器接收 POST JSON 的地址」到本地，便于备忘。请确保该地址能在您的服务器上接收 POST 请求。

JSON 模拟推送测试沙箱

解析终端 黑底终端流 · 绿字正文

调用记录日志

自动记录通过本页发起的所有 POST 请求（含请求体、HTTP 状态、解析后的响应体、耗时）。 导出 JSON 中同时附带全量接口地址及入参/出参字段注释：登录相关为文档级细项，其余模块为通用响应壳 + appId 说明，并指向仓库内对应 Markdown。

时间 路径 HTTP ret 异常 耗时