主题
批量更新企业微信按钮 3.6.2.SP8+(不包含 3.7.1Beta1)
接口说明
请求URL:http[s]://{网关地址}/mp/restful/v2/batchUpdateWorkWeiXinCard
请求方式: POST
请求内容类型: application/json
响应内容类型: application/json
请求说明
请求体
| 参数名 | 字段名 | 必填 | 类型 |
|---|---|---|---|
| msgId | 应消息id(消息发送2.0的返回的msgid) | M | string |
| updateJson | 更新卡片的json,json对象转成的字符串,具体实例可以查看,企业微信示例中的userids、resposne_code和agentid不用传递,示例中的("partyids", "tagids" )不可以使用 ,消息中心会拼接上 https://developer.work.weixin.qq.com/document/path/94888#按钮交互型 | M | string |
请求示例
json
{
"msgId": "937429478933504", //消息id
"updateJson": " { \"button\":{ \"replace_name\": \"替换的内容\" } }"
}1
2
3
4
2
3
4
响应说明
响应体
| 字段名 | 参数名 | 类型 | 描述 |
|---|---|---|---|
| 状态码 | code | String | 0000请求成功 |
| 错误内容 | msg | string | 错误内容(里面会有消息业务错误以及企业微信返回的错误,消息只是做传递不做具体业务处理) |
| 无效的用户 | invalidUserIds | List<String> | 更新失败的用户账号列表 |
响应示例
json
{
"code": "0000",
"invalidUserIds":["ampadmin","01119092"]
}1
2
3
4
2
3
4
错误码
| 错误码 | 描述 |
|---|---|
| 0000 | 请求成功 |
| 其他 | 失败 |
Demo
java
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
BatchUpdateWorkWeiXinCardRequest request = new BatchUpdateWorkWeiXinCardRequest();
request.setMsgId("992925348073472");
request.setUpdateJson(" { \"button\":{ \"replace_name\": \"替换的内容\" } }" );
BatchUpdateWorkWeiXinCardResponse execute = client.execute(request);
if (execute.isSuccess()) {
System.out.println(JSONObject.toJSONString(execute));
} else {
throw new Exception("获取启用通道异常:" + JSONObject.toJSONString(execute));
}1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10

