# 批量冻结解冻接口
# 接口说明:
批量冻结解冻用户,单次最多传 100 人
# 请求方法:
POST (application/json)
# 请求地址:
https://open.wecard.qq.com/cgi-bin/user/manage/change-frozen-status?access_token=ACCESS_TOKEN
# 参数说明:
{
"list":[
{
"card_number":"CARD_NUMBER_1",
"status":0,
"reason":"⻓期未使用冻结",
"end_at":"2023-01-01 17:01:01"
},
{
"card_number":"CARD_NUMBER_2",
"status":1
}
]
}
参数 | 必填 | 类型 | 说明 |
---|---|---|---|
access_token | 是 | String | 接口请求凭证 |
list | 是 | Array | 需要冻结解冻的用户数组 |
card_number | 是 | String | 电子卡号/学工号 |
status | 是 | Integer | 状态:0 - 冻结, 1 - 解冻 |
reason | 否 | String | 冻结原因 (仅 status = 0 时有效) |
end_at | 否 | String | 冻结截止时间,不传或传空字符串表示永久冻结(仅 status = 0 时有效) |
# 响应说明:
{
"errcode":0,
"errmsg":"OK",
"fail_list": [
{
"code":10111,
"msg":"用户已冻结,请勿重复冻结",
"card_number":"CARD_NUMBER_1"
},
{
"code":10109,
"msg":"用户不存在",
"card_number":"CARD_NUMBER_2"
}
]
}
# 错误码说明
错误码 | 说明 |
---|---|
10109 | 用户不存在 |
10111 | 系统异常,请稍后重试 |
10112 | 人数超过限制 |
10114 | 操作无效,电子卡号/学工号重复 |
10115 | 操作无效,数据格式有误 |
10116 | 操作无效,冻结截止时间有误 |
46201 | 冻结用户异常 |
46202 | 解冻用户异常 |
46126 | 用户已解冻,请勿重复解冻 |