接入必读
wekeapi 提供微信协议 API 接口能力，开发者可以通过 API 调用，完成常见微信操作，如消息收发、好友管理、群管理、标签管理等。您可以基于 wekeapi 提供的基础能力，开发自己的业务系统，如私域营销、社群运营、智能客服等，也可以结合 AI Agent、OpenClaw 类工具开发 AI数字员工等 AI应用。
使用要求
1.
2.
微信使用的一些概念
微信号
别名属性好友微信名
群成员微信昵称
响应格式
{
code: 0,
message: "响应信息",
data: {}
}错误信息
常见错误排查
| Code | Message | 说明 |
|---|---|---|
| -10 | 认证失败 | 检查 AccessToken 是否正确，AppId 是否属于该 AccessToken |
| -11 | 参数错误 | 接口传参未通过校验，检查参数是否符合要求 |
| -12 | 调用超限 | 接口调用频次过高，超过系统限制（目前仅对发送类接口做限制） |
| -21 | 账号已登录 | 调用登录相关接口时，账号已登录 |
| -22 | 账号未登录 | 调用要求账号登录的接口时，账号未登录 |
| -33 | 无对应资源 | 接收消息后下载图片或视频时，无对应规格的资源（对方可能没有发原图，或视频没有压缩常规视频等情况） |
| -43 | 通讯录同步进行中 | 获取通讯录列表或强制更新通讯录时，后台正在进行通讯录同步 |
| -51 | 网络连接异常 | 调用接口或更换代理时网络不通，检查代理的连通性 |
完整错误列表
| Code | Message |
|---|---|
| -10 | 认证失败 |
| -11 | 参数错误 |
| -12 | 调用超限 |
| -13 | Base64参数解码错误 |
| -14 | xml参数解析错误 |
| -15 | xml参数数据不完整 |
| -16 | 代理格式错误 |
| -20 | 账号限额已用完 |
| -21 | 账号已登录 |
| -22 | 账号未登录 |
| -23 | 账号未在线 |
| -24 | 登录失败 |
| -30 | 不支持的格式 |
| -31 | 大小超过限制 |
| -32 | 时长超过限制 |
| -33 | 无对应资源 |
| -40 | 操作过于频繁 |
| -41 | 二维码已过期 |
| -42 | 群聊邀请已过期 |
| -43 | 通讯录同步进行中 |
| -50 | 服务异常 |
| -51 | 网络连接异常 |
| -52 | 后端接口返回错误 |
调用频率
1.
2.
私有化部署
联系方式
修改于 2026-06-03 02:23:55