批量更新应用的通讯录权限范围

适用版本 >=v7.0.2510.20251225

接口说明：批量更新应用的通讯录权限范围，支持新增和删除，仅支持企业自建应用。

标签：应用管理

请求说明

字段	值
请求地址	配置域名+/openapi+/v7/developer/apps/{app_id}/contacts_range/batch_update
HTTP 方法	POST
接口描述	批量更新应用的通讯录权限范围，支持新增和删除，仅支持企业自建应用。 注意： 1. 私网最多支持配置 1500 项内容；公网支持白名单项，目前白名单项最多支持配置 1500 项内容，非白名单项最多支持配置 200 项内容； 2. 设置【全部成员】和【与可用范围一致】为全量更新方式；设置【权限范围列表】为批量更新方式。
签名方式	KSO-1（配置域名+/openapi不参与签名）
限频策略	无
权限要求	查询和管理应用版本信息(应用授权) kso.app_version.readwrite

请求头 (Headers)

属性名	类型	是否必填	描述	可选值
X-Kso-Id-Type	string	否		internal, external
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT	-
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》	-
Authorization	string	是	授权凭证，格式为：Bearer {access_token}	-

路径参数 (Path)

属性名	类型	是否必填	描述	可选值
app_id	string	是	应用id	-

请求体(Body)

请求体格式: application/json

没有可用的数据

请求体示例

{
  "add_items": [
    {
      "id": "string",
      "name": "string",
      "partner_company_id": "string",
      "partner_id": "string",
      "partner_name": "string",
      "type": "company"
    }
  ],
  "all_members": true,
  "remove_items": [
    {
      "id": "string",
      "name": "string",
      "partner_company_id": "string",
      "partner_id": "string",
      "partner_name": "string",
      "type": "company"
    }
  ],
  "same_with_visible": true
}

响应体(Response)

HTTP状态码: 200
响应体格式: application/json

没有可用的数据

响应体示例

{
  "code": 0,
  "msg": "string"
}