# 批量冻结解冻接口
# 接口说明:
批量冻结解冻用户,单次最多传 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 | 用户已解冻,请勿重复解冻 |