分配用户席位

调用该接口为成员分配指定应用的席位。

接口按 union_ids 顺序尝试分配。单个成员失败不会回滚此前已成功的成员;成员已经持有目标席位时按成功处理,不重复占用额度。

请求

基本
请求方式POST
请求地址/openapi/v2/licenses/access/assign

请求头

名称类型必填描述
Authorizationstring是值格式:Bearer {{access_token}}

调用 API 时,需要通过访问凭证(access_token)进行身份鉴权,不同类型的访问凭证可获取的数据范围不同,参考 获取访问凭证 。

支持鉴权类型:
• 应用级token:以应用身份调用 API,校验应用的数据访问范围。参考 获取企业内部应用access_token。
Content-Typestring是固定值:application/json; charset=utf-8

请求体

请求参数

名称类型必填描述
app_typestring是目标应用类型。
feature_codestring是目标席位功能编码。
union_idsstring[]是成员 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}