name: qiwei-api-catalog

description: 通过 Fmode 网关转发的企业微信接口调用消息、群管理、联系人、朋友圈、标签、会话、账号和文件等 100+ 个能力；先查清单、读文档，再用 qiwei_api_call 调用。企业微信接口访问凭据由 Fmode 网关管理。

企业微信接口清单驱动调用

调用架构

所有普通业务请求都通过 Fmode 网关转发的企业微信接口：

{
  "uid": "<本地稳定设备标识>",
  "method": "/msg/sendText",
  "params": {
    "toId": "168...",
    "content": "hello"
  }
}

请求头使用 Fmode 鉴权：

Authorization: Bearer <Fmode token>

Fmode 网关负责：

校验用户或公司身份；
检查企微包月订阅；
将 uid 映射为设备上下文；
管理企业微信接口访问凭据；
转发企业微信接口请求并返回结果。

客户端不得索要、保存或传递企业微信接口访问凭据。

标准流程

用 qiwei_api_search 按关键词、module 或 tag 找接口；
用 qiwei_api_doc 核对必填参数和返回字段；
用 qiwei_api_call 传 id + params；
收到订阅错误时调用 qiwei_subscription_status，必要时用 qiwei_subscribe；
收到登录态错误时调用 qiwei_login_status，必要时转 qiwei-login 技能重新扫码。

清单里没有的普通 JSON 接口可以传 rawMethod + params。/login/*、/client/* 必须走登录专用工具，不能透传。

模块

msg：消息收发、撤回、群发、历史消息同步；
room：建群、成员、管理员、公告、群二维码等；
contact：联系人、好友申请与客户管理；
sns：朋友圈发布、列表、点赞与评论；
label：个人标签和客户标签；
session：会话分页与会话组；
user：个人与企业信息；
cloud：文件接口；本地文件通过 qiwei_api_call 的 filePath 字段走 Fmode multipart 中转；
login / client：仅用于文档检索，实际操作走 qiwei-login。

注意事项

消息发送前通常需要先查询联系人 userId 或群 roomId。
批量发送、加好友、拉群等操作应控制频率并遵守平台风控。
不向用户展示 Authorization、Fmode token、接口服务提供方名称、相关域名或内部错误栈。