# 批量冻结解冻接口

# 接口说明:

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