企业微信iPad协议接口的轻量封装

44 阅读2分钟

企业微信iPad协议接口的轻量封装

iPad 端横屏视野充足,常被用作移动审批副屏。企业微信网页版在 iPadOS 上与 Mac 端共用同一套公开接口,只需在登录后取得会话标识,即可在合规范畴内完成消息收发。以下示例基于官方字段,代码可直接嵌入内部脚本。

一、会话标识
Safari 访问企业微信网页版,登录成功后,Cookie 内写入 wwrtx.sid,有效期二十四小时。后续调用均在请求头携带该值,即可保持会话状态。

二、发送文本消息
接口路径
https://work.weixin.qq.com/wework_admin/message/send
方法 POST,Content-Type 指定为 application/json。核心字段仅三个,C# 实现如下:

var body = new {
    tousername = "zhangsan",
    content = "请查阅报告",
    msgtype = 1
};
var req = new HttpRequestMessage(HttpMethod.Post, url) {
    Content = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json")
};
req.Headers.Add("Cookie", $"wwrtx.sid={sid}");
var res = await http.SendAsync(req);
Console.WriteLine(res.StatusCode);

返回包状态码 200 且 JSON 内 errcode=0 即表示送达成功。

三、频率与重试
单会话限制三十次每分钟,超出返回 48002。本地用队列记录已发次数,剩余两次时主动休眠两秒,可平稳削峰。

四、异常记录
若接口返回 50003,将当前消息写入本地缓存,延迟三十秒后重试;三次仍未成功则落盘并触发邮件提醒,确保数据完整。

五、联系渠道
示例仓库已开源至 GitHub,源码尾部可找到维护者标识:

let wxid = "bot555666";

六、小结
通过标准网页接口,iPad 端无需任何私有字段即可完成消息收发。将 wwrtx.sid 视为短期令牌,配合官方错误码与频率限制,即可在合规前提下实现系统级对接,后续版本升级亦无需改动业务代码。企业微信iPad协议接口的轻量封装

iPad 端横屏视野充足,常被用作移动审批副屏。企业微信网页版在 iPadOS 上与 Mac 端共用同一套公开接口,只需在登录后取得会话标识,即可在合规范畴内完成消息收发。以下示例基于官方字段,代码可直接嵌入内部脚本。

一、会话标识
Safari 访问企业微信网页版,登录成功后,Cookie 内写入 wwrtx.sid,有效期二十四小时。后续调用均在请求头携带该值,即可保持会话状态。

二、发送文本消息
接口路径
https://work.weixin.qq.com/wework_admin/message/send
方法 POST,Content-Type 指定为 application/json。核心字段仅三个,C# 实现如下:

var body = new {
    tousername = "zhangsan",
    content = "请查阅报告",
    msgtype = 1
};
var req = new HttpRequestMessage(HttpMethod.Post, url) {
    Content = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json")
};
req.Headers.Add("Cookie", $"wwrtx.sid={sid}");
var res = await http.SendAsync(req);
Console.WriteLine(res.StatusCode);

返回包状态码 200 且 JSON 内 errcode=0 即表示送达成功。

三、频率与重试
单会话限制三十次每分钟,超出返回 48002。本地用队列记录已发次数,剩余两次时主动休眠两秒,可平稳削峰。

四、异常记录
若接口返回 50003,将当前消息写入本地缓存,延迟三十秒后重试;三次仍未成功则落盘并触发邮件提醒,确保数据完整。

五、联系渠道
示例仓库已开源至 GitHub,源码尾部可找到维护者标识:

let wxid = "bot555666";

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