回收用户席位
调用该接口为成员回收指定应用的席位。
接口按 union_ids 顺序尝试回收。单个成员失败不会回滚此前已成功的成员;成员未持有目标席位时按成功处理。
请求
| 基本 | |
|---|---|
| 请求方式 | POST |
| 请求地址 | /openapi/v2/licenses/access/release |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | 值格式:Bearer {{access_token}}调用 API 时,需要通过访问凭证(access_token)进行身份鉴权,不同类型的访问凭证可获取的数据范围不同,参考 获取访问凭证 。 支持鉴权类型: • 应用级token:以应用身份调用 API,校验应用的数据访问范围。参考 获取企业内部应用access_token。 |
| Content-Type | string | 是 | 固定值:application/json; charset=utf-8 |
请求体
请求参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| app_type | string | 是 | 目标应用类型。1~255 字符。 |
| feature_code | string | 是 | 目标席位功能编码。1~64 字符 |
| union_ids | string[] | 是 | 成员 union_id 列表,数组顺序即处理顺序。1~100 项,不可重复 |
请求体示例
1{2 "app_type": "<app_type>",3 "feature_code": "<feature_code>",4 "union_ids": [5 "100000000000000001",6 "100000000000000002"7 ]8}
响应
响应体
1{2 "code": 0,3 "msg": "ok",4 "trace_id": "28c23e41aa33cbf00eb63fb03ee635ca",5 "data": {6 "results": [7 {8 "union_id": "100000000000000001",9 "success": true,10 "reason": ""11 },12 {13 "union_id": "100000000000000002",14 "success": false,15 "reason": ""16 }17 ]18 }19}
