# 新增参与人共享人

来源快照：`result_data_new_260518.json`

- 来源 ID：`1228084196856913939`
- 模块：日程管理
- 目录：日程接口 - 通用api接口
- space ID：`4525671506136445704`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 参与人共享人修改接口文档

## 1\. 接口基本信息

项目| 说明  
---|---  
接口名称| 参与人共享人修改  
接口路径| PC接口：/api/calendar/table/addH5接口：/api/app/calendar/table/add  
请求方法| POST  
接口描述| 用于修改日程的参与人/共享人权限配置，新增共享权限记录  
响应格式| JSON  
  
## 2\. 请求参数

### 2.1 请求体格式

请求体为 JSON 数组格式，数组内单个元素结构如下：

字段名| 类型| 是否必填| 说明  
---|---|---|---  
id| String| 是| 人员ID（主身份ID）  
cid| String| 否| 租户/企业内标识ID  
userid| String| 是| 用户唯一标识ID  
name| String| 否| 参与人/共享人姓名  
statusCode| String| 否| 状态码，固定值"normal"表示正常  
content| String| 否| 内容描述（一般为姓名）  
title| String| 否| 标题（格式：姓名|所属部门/租户）  
contentDesc| String| 否| 内容描述，同content  
department| String| 否| 所属部门/租户名称  
avatar| Object| 否| 头像信息对象，详见下方avatar结构  
indexType| String| 否| 索引类型，固定值"X"  
isLeaf| Boolean| 否| 是否为叶子节点，固定值true  
mobile| String| 否| 手机号码  
templateType| String| 否| 模板类型，固定值"default"  
originTargetType| String| 否| 原始目标类型，固定值"user"（表示目标为用户）  
richContent| String| 否| 富文本内容，一般为姓名  
departmentId| String| 否| 所属部门ID  
mainId| String| 否| 主身份ID，同id字段  
leaf| Boolean| 否| 同isLeaf，固定值true  
stopDepartment| Boolean| 否| 是否停止部门层级，固定值false  
_entityType| String| 是| 实体类型，固定值"user"  
objType| String| 是| 对象类型，固定值"resource"  
objTypeSpan| String| 是| 对象类型描述，固定值"人员"  
obj_id| Array| 是| 嵌套的人员信息数组，结构同外层人员信息  
obj_id_span| String| 否| 嵌套人员名称，同name  
objIdList| Array| 否| 人员名称列表，仅包含姓名字符串  
shareKey| String| 否| 共享密钥，唯一标识本次共享操作  
targetId| String| 是| 目标人员ID，同id字段  
targetType| Integer| 是| 目标类型，固定值1（表示用户类型）  
sourceType| Integer| 是| 来源类型，固定值1  
permissionId| String| 是| 权限ID，固定值"calendar_share"（日历共享）  
permissionType| Integer| 是| 权限类型  
3： 参与人  
1：共享人  
module| String| 是| 模块名称，固定值"calendar"（日历模块）  
sourceId| String| 是| 日程ID（关联的日历日程唯一标识）  
entryType| String| 是| 条目类型，固定值"user"  
  
### 2.2 avatar 子对象结构

字段名| 类型| 是否必填| 说明  
---|---|---|---  
previewPath| String| 是| 头像预览路径（文件预览接口地址）  
appPreviewPath| String| 是| 移动端头像预览路径  
name| String| 是| 头像关联姓名，同外层name  
userId| String| 是| 头像关联用户ID，同外层id  
  
### 2.3 请求示例
    
    
    [
        {
            "id":"3335144704318601898",
            "cid":"1149849619635568640",
            "userid":"4523373093352457653",
            "name":"谢丽青",
            "statusCode":"normal",
            "content":"谢丽青",
            "title":"谢丽青|轻文档云上租户",
            "contentDesc":"谢丽青",
            "department":"轻文档云上租户",
            "avatar":{
                "previewPath":"/api/file/preview?type=redirect&imgFormat=small&fileId=",
                "appPreviewPath":"/api/app/file/preview?type=redirect&imgFormat=small&fileId=",
                "name":"谢丽青",
                "userId":"3335144704318601898"
            },
            "indexType":"X",
            "isLeaf":true,
            "mobile":"13764446058",
            "templateType":"default",
            "originTargetType":"user",
            "richContent":"谢丽青",
            "departmentId":"1149849619690790942",
            "mainId":"3335144704318601898",
            "leaf":true,
            "stopDepartment":false,
            "_entityType":"user",
            "objType":"resource",
            "objTypeSpan":"人员",
            "obj_id":[
                {
                    "id":"3335144704318601898",
                    "cid":"1149849619635568640",
                    "userid":"4523373093352457653",
                    "name":"谢丽青",
                    "statusCode":"normal",
                    "content":"谢丽青",
                    "title":"谢丽青|轻文档云上租户",
                    "contentDesc":"谢丽青",
                    "department":"轻文档云上租户",
                    "avatar":{
                        "previewPath":"/api/file/preview?type=redirect&imgFormat=small&fileId=",
                        "appPreviewPath":"/api/app/file/preview?type=redirect&imgFormat=small&fileId=",
                        "name":"谢丽青",
                        "userId":"3335144704318601898"
                    },
                    "indexType":"X",
                    "isLeaf":true,
                    "mobile":"13764446058",
                    "templateType":"default",
                    "originTargetType":"user",
                    "pid":"",
                    "richContent":"谢丽青",
                    "departmentId":"1149849619690790942",
                    "mainId":"3335144704318601898",
                    "leaf":true,
                    "stopDepartment":false
                }
            ],
            "obj_id_span":"谢丽青",
            "objIdList":["谢丽青"],
            "shareKey":"temp_resource_3335144704318601898_401520",
            "targetId":"3335144704318601898",
            "targetType":1,
            "sourceType":1,
            "permissionId":"calendar_share",
            "permissionType":3,
            "module":"calendar",
            "sourceId":"1228079893390311425",
            "entryType":"user"
        }
    ]

## 3\. 响应参数

### 3.1 响应体整体结构

字段名| 类型| 说明  
---|---|---  
code| Integer| 响应码，200表示成功  
msg| String| 响应信息，"接口返回成功"表示操作成功  
status| Boolean| 接口调用状态，true表示成功  
data| Array| 共享权限记录数组，数组内单个元素为新增的共享权限详情  
fail| Boolean| 是否失败，false表示未失败  
  
### 3.2 data 数组内单个元素结构

字段名| 类型| 说明  
---|---|---  
id| String| 新增的共享权限记录ID  
createTime| Long| 创建时间戳（毫秒）  
updateTime| Long| 更新时间戳（毫秒）  
creator| String| 创建人ID  
tenantKey| String| 租户标识  
deleteType| Integer| 删除类型，0表示未删除  
sourceType| Integer| 来源类型，固定值1  
permissionId| String| 权限ID，固定值"calendar_share"  
moduleId| String| 模块ID，固定值"calendar"  
sourceId| String| 关联的日程ID  
sourceMinSecLevel| Integer| 来源最小密级  
sourceMaxSecLevel| Integer| 来源最大密级  
sourceSubordinateInclude| Boolean| 来源是否包含下级，固定值false  
sourceImmediateCalc| Boolean| 来源是否立即计算，固定值false  
targetType| Integer| 目标类型，固定值1（用户）  
targetId| String| 目标人员ID  
targetMinSecLevel| Integer| 目标最小密级  
targetMaxSecLevel| Integer| 目标最大密级  
targetSubBordinateInclude| Boolean| 目标是否包含下级，固定值false  
targetSupBordinateInclude| Boolean| 目标是否包含上级，固定值false  
targetImmediateCalc| Boolean| 目标是否立即计算，固定值false  
permissionType| Integer| 权限类型，固定值3  
tableName| String| 关联的数据表名，固定值"agenda"（日程表）  
download| Integer| 下载权限，1表示允许下载  
filterDownload| Boolean| 是否过滤下载，固定值false  
shareKey| String| 共享密钥，与请求参数中的shareKey一致  
enableExtend| Boolean| 是否启用扩展，固定值false  
  
### 3.3 响应示例
    
    
    {
        "code": 200,
        "msg": "接口返回成功",
        "status": true,
        "data": [
            {
                "id": "1228082934118105088",
                "createTime": 1769135340405,
                "updateTime": 1769135340405,
                "creator": "3336092759608873235",
                "tenantKey": "tfceonshov",
                "deleteType": 0,
                "sourceType": 1,
                "permissionId": "calendar_share",
                "moduleId": "calendar",
                "sourceId": "1228079893390311425",
                "sourceMinSecLevel": 0,
                "sourceMaxSecLevel": 9999,
                "sourceSubordinateInclude": false,
                "sourceImmediateCalc": false,
                "targetType": 1,
                "targetId": "3335144704318601898",
                "targetMinSecLevel": -1,
                "targetMaxSecLevel": 999,
                "targetSubBordinateInclude": false,
                "targetSupBordinateInclude": false,
                "targetImmediateCalc": false,
                "permissionType": 3,
                "tableName": "agenda",
                "download": 1,
                "filterDownload": false,
                "shareKey": "temp_resource_3335144704318601898_401520",
                "enableExtend": false
            }
        ],
        "fail": false
    }

## 4\. 错误码说明

错误码| 说明| 排查建议  
---|---|---  
200| 成功| -  
其他| 失败（需结合msg字段）| 1\. 检查请求参数是否完整且格式正确  
2\. 检查sourceId（日程ID）是否存在  
3\. 检查targetId（人员ID）是否有效  
4\. 检查租户权限是否正常
