跳转至

批量更新渠道商子公司的部门额度

接口说明:
  • 支持渠道商通过开放平台批量设置指定子公司一级部门的拍摄套数额度
  • 只能给一级部门设置;多级子部门上传时按所属一级部门额度判断
  • 各部门 upload_total_count 之和不能超过该公司 upload_total_count
  • upload_total_count 允许为 0(禁止该一级部门及其下级上传)
  • clear: true 删除该部门配额配置,恢复为未配置(不做部门限制)
请求路径:

{HostName}/api/v2/op/openapi/channel_merchant/customer/department/

请求方式:
  • POST
Headers:
{
  "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 整批失败,不会部分写入