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

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

## 调用架构

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

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

请求头使用 Fmode 鉴权：

```text
Authorization: Bearer <Fmode token>
```

Fmode 网关负责：

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

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

## 标准流程

1. 用 `qiwei_api_search` 按关键词、module 或 tag 找接口；
2. 用 `qiwei_api_doc` 核对必填参数和返回字段；
3. 用 `qiwei_api_call` 传 `id + params`；
4. 收到订阅错误时调用 `qiwei_subscription_status`，必要时用 `qiwei_subscribe`；
5. 收到登录态错误时调用 `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、接口服务提供方名称、相关域名或内部错误栈。