常规授权批量删除
说明
按外部授权编码批量删除企业的有效常规授权。企业须开通 AUTHORIZED_REIMBURSEMENT 功能,单次最多删除 50 条。
批次内逐条处理;单条失败只回滚该条,不影响后续条目。删除后,原 businessCode 会按规则变更,避免与后续新建授权冲突。
接口限制
1. 单次最多处理 50 条数据;
2. 单条失败模式。批次内各条数据互不影响,某条失败不影响其他条目继续执行。
接口地址
/api/openapi/user-delegation/batch/delete
请求类型
POST
请求参数
参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| businessCodeList | List<String> | 是 | 待删除常规授权的外部编码列表 |
参数样例
{
"businessCodeList": [
"AUTH-2026-001",
"AUTH-2026-002"
]
}
响应参数
参数样例
- 正常响应参数示例
{
"code": "ACK",
"message": "",
"data": null,
"errorCode": null,
"success": true
}
- 错误返回示例
当有数据发生错误时,code 返回 NACK,data.errorData 仅包含失败条目;key 为该条 businessCode,errorIndex
为其在请求数组中的下标(从 0 开始)。已成功删除的条目不会回滚。
{
"success": false,
"code": "NACK",
"message": "",
"data": {
"errorData": [
{
"key": "AUTH-2026-002",
"errorCode": "AUTH_NOT_FOUND",
"errorMessage": "待删除的有效常规授权不存在",
"errorIndex": 1
}
]
}
}
errorData 中的 errorCode 说明
| 错误码 | 说明 |
|---|---|
AUTH_NOT_FOUND |
待删除的有效常规授权不存在 |
AUTHORIZED_REIMBURSEMENT_NOT_ENABLED |
企业未开通常规授权管理功能 |
999997 |
批量请求为空或参数无效 |
999998 |
单次请求超过 50 条 |
999999 |
未归类的服务端错误 |