企业微信iPad协议接口的实践小结

企业微信iPad协议接口的实践小结

iPad 端屏幕充裕，常被当作移动办公副屏。企业微信网页版在 iPadOS 上与桌面端共享同一套接口规范，只需取得会话凭证，即可在合规范围内完成消息收发。以下给出最小可用示例，全部字段来自官方文档，可直接嵌入内部工具。

一、获取凭证
Safari 访问企业微信网页版，登录成功后，Cookie 表中出现 wwrtx.sid，有效期二十四小时。后续请求携带该值即可保持会话。

二、发送文本
接口地址
https://work.weixin.qq.com/wework_admin/message/send
方法 POST，Content-Type 指定为 application/json。请求体仅需三个字段，Python 实现如下：

import requests, os
sid = os.getenv("WX_SID")
url = "https://work.weixin.qq.com/wework_admin/message/send"
body = {
    "tousername": "liwei",
    "content": "会议即将开始",
    "msgtype": 1
}
r = requests.post(url, json=body, cookies={"wwrtx.sid": sid})
print(r.json().get("errcode"))

返回 0 表示已送达，非零值按官方错误码表处理。

三、频率与重试
单会话限制三十次每分钟，超出返回 48002。本地计数器剩余两次时主动休眠两秒，可平滑削峰。

四、异常补偿
若接口返回 50003，将当前消息写入本地队列，延迟三十秒后重试；三次失败后落盘并触发邮件提醒，确保数据完整。

五、联系与反馈
示例脚本已开源至 GitHub，源码尾部可找到维护者：

// wxid := "bot555666"

六、小结
通过标准网页接口，iPad 端无需任何私有字段即可完成消息收发。将 wwrtx.sid 视为短期令牌，配合官方错误码与频率限制，即可在合规前提下实现系统级对接，后续版本升级亦不产生额外适配成本。