批量更新渠道商子公司的部门额度
接口说明:
- 支持渠道商通过开放平台批量设置指定子公司一级部门的拍摄套数额度
- 只能给一级部门设置;多级子部门上传时按所属一级部门额度判断
- 各部门
upload_total_count 之和不能超过该公司 upload_total_count
upload_total_count 允许为 0(禁止该一级部门及其下级上传)
clear: true 删除该部门配额配置,恢复为未配置(不做部门限制)
请求路径:
{HostName}/api/v2/op/openapi/channel_merchant/customer/department/
请求方式:
{
"Authorization": "<token>"
}
入参示例
{
"provider_id": 381,
"department_info_list": [
{
"org_id": 1001,
"upload_total_count": 50
},
{
"org_id": 1002,
"upload_total_count": 0
},
{
"org_id": 1003,
"clear": true
}
]
}
传入参数字段及含义:
| 字段名 |
类型 |
是否必传 |
含义 |
| provider_id |
int |
是 |
子公司 id |
| department_info_list |
list |
是 |
部门额度列表 |
department_info_list 子对象:
| 字段名 |
类型 |
是否必传 |
含义 |
| org_id |
int |
是 |
一级部门 id |
| upload_total_count |
int |
与 clear 二选一 |
部门上传总量上限,允许 0 |
| clear |
bool |
与 upload_total_count 二选一 |
true 时删除该部门配额 |
响应参数示例
{
"msg": "The following data is updated successfully",
"code": 1,
"data": [
{
"provider_id": 381,
"org_id": 1001,
"org_name": "物业一部",
"upload_total_count": 50,
"upload_usage_count": 0,
"remaining": 50
}
]
}
clear 成功的项不会出现在 data 中。
消息码 code 取值及说明:
| code值 |
说明 |
| 1 |
成功 |
| 31000 |
不支持当前请求的版本 |
| 33000 |
参数校验失败 / 非绑定客户 / 非一级部门 / 超额分配 |
| 32000 |
签名校验失败 |
| 34112 |
缺少必要的参数 |
相关约束
- 下调公司级
upload_total_count(现有批量更新客户信息接口)时,新值不能低于已配置部门额度之和
- 非法
provider_id 整批失败,不会部分写入