# 工作日程服务管理

# 接口调用方式

本接口为主OA Http Rest,允许被异构系统远程调用,调用前需要调用Rest接口文档 (opens new window)获取Restful token身份凭证。

# 工作日程对象

# 日程对象示例

{
    "id": 7646314703911537000, 
    "alarmDate": 0, 
    "alarmFlag": false, 
    "completeRate": 0, 
    "beforendAlarm": 0, 
    "attachmentsFlag": true, 
    "createDate": 1398392311000, 
    "createUserId": -2295828016161864200, 
    "periodicalId": null, 
    "beginDate": 1398652200000, 
    "endDate": 1399258800000, 
    "eventType": 1, 
    "shareType": 8, 
    "signifyType": 0, 
    "states": 1, 
    "subject": "标题", 
    "shareTarget": "长孙无忌、房玄龄、杜如晦", 
    "updateDate": 1398671562000, 
    "workType": 1, 
    "eventflag": 0, 
    "tranMemberIds": "Member|-3130779376371089245,Member|-4964206632820652806,Member|-5075688473466224369", 
    "tranMemberName": null, 
    "receiveMemberId": null, 
    "receiveMemberName": null, 
    "fromType": 11, 
    "fromId": null, 
    "periodicalStyle": 0, 
    "calEventType": 0, 
    "isEntrust": 0, 
    "periodicalChildId": null, 
    "accountID": -5964772578102723000, 
    "priorityType": 1, 
    "realEstimateTime": 0, 
    "fromRecordId": null, 
    "attachmentSubject": "标题", 
    "new": true, 
    "extraMap": { }
}

# 日程属性说明

id 主键ID
alarmDate 提醒时间
alarmFlag 提醒的标识
completeRate 完成率
beforendAlarm 提前提醒时间
attachmentsFlag
createDate 创建时间
createUserId 创建者
periodicalId
beginDate 开始时间
endDate 结束时间
eventType 事件类型
shareType 共享类型
signifyType 重要程度
states 事件完成类型
subject 标题
shareTarget 共享对象name
updateDate 更新时间
workType 工作类型
eventflag 事件当前类型标识
tranMemberIds
tranMemberName
receiveMemberId
receiveMemberName
fromType 其他模块转日程的类型
fromId 其他模块转日程的id
periodicalStyle
calEventType
isEntrust
periodicalChildId
accountID 创建人创建事件对应的公司ID
priorityType 优先级类型
realEstimateTime 实际完成时间
fromRecordId 优先级类型
attachmentSubject 附件名称
new
extraMap -

# 按日程Id取得日程信息

开发者可以通过【日程ID】来获取日程信息。

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/event/{eventId}

注:请求需要携带token,否则无法使用,获取并传递token方法参考:https://open.seeyoncloud.com/seeyonapi/781/

参数说明:

参数 是否必须 说明
eventId 日程ID

返回说明

正常情况下,会返回的是JSON格式日程信息,JSON数据包参考:日程对象示例

参数说明 请参考:日程属性说明

# 新增日程信息

# 接口URL

http://ip:port/seeyon/rest/event/add

# 请求方式

POST

# Content-Type

json

# 请求Header参数

参数名 示例值 参数类型 是否必填 参数描述
token 05155e3c-7270-4110-90d2-7d9450278302 String 获取token接口中的id

注:请求需要携带token,否则无法使用,获取并传递token方法参考:https://open.seeyoncloud.com/seeyonapi/781/

# 请求Body参数

{
    "subject": "标题", 
    "calEventType": 2, 
    "beginDate": 1721275200000, 
    "endDate": 1721296800000, 
    "signifyType":2,
    "states": 2, 
    "completeRate": 30, 
    "alarmDate": 5000, 
    "beforendAlarm": 5000, 
    "shareType": 4, 
    "tranMemberIdsOther": "Member|-8656646177573419945", 
    "content": "测试", 
    "workType": 1, 
    "periodicalType": 0, 
    "from": "robot"
}
参数名 示例值 参数类型 是否必填 参数描述
subject 标题 String 标题
calEventType 2 Integer 事件类型(0.业务1.管理 2.个人 3.其它 )默认为0
beginDate 1721275200000 Integer 开始时间
endDate 1721296800000 Integer 结束时间
signifyType 2 Integer 重要程度(0.重要紧急1.不重要紧急2.重要不紧急3.不重要不紧急)
states 2 Integer 事件完成类型(1.待安排 2.已安排3.处理中 4.已完成)默认:1
completeRate 30 Integer 完成率,与事件完成类型有关,如果为已完成的时候必须为100
alarmDate 5000 Integer 开始前提醒时间{@link AlarmDateEnum}
beforendAlarm 5000 Integer 结束前提醒时间{@link AlarmDateEnum}
shareType 4 Integer 共享类型(1.私人事件4.公开给他人)
tranMemberIdsOther Member|-8656646177573419945 String 固定Member|人员ID,多个人员以逗号分隔
content 测试 String 事件内容
workType 1 Integer 工作类型(1.自办2.督办3.协办)默认1
periodicalType 0 Integer 周期类型(0:无;1:按天;2:按周;3:按月;4:按年),默认:0
from robot String 创建来源(*目前只支持,robot:机器人)

# 成功响应示例

true

# 错误响应示例

{
  "code" : 500,
  "success" : false,
  "message" : null
}
参数名 示例值 参数类型 参数描述
code 400 Integer 状态码
success false Boolean -
message For input string: "-64946588957000160841" String -

# 修改日程信息

# 接口URL

http://ip:port/seeyon/rest/event/update

# 请求方式

POST

# 请求Header参数

参数名 示例值 参数类型 是否必填 参数描述
token 54db786c-d2c2-4240-9474-cec2b41202a4 String 获取token接口中的id

注:请求需要携带token,否则无法使用,获取并传递token方法参考:https://open.seeyoncloud.com/seeyonapi/781/

# 请求Body参数

{
    "calEventID": 144428946517409946,
    "subject": "测试qqqqqqqqq",
    "beginDate": 1715151600000,
    "endDate": 1715162400000,
    "shareType": 4,
    "tranMemberIdsOther": "Member|-6494658895700016084",
    "content": "aaaaaa",
    "states": 1
}
参数名 示例值 参数类型 是否必填 参数描述
calEventID -3819209005587412500 Integer 日程ID
subject 测试qqqqqqqqq String 标题
beginDate 1714355280770 Integer 开始时间
endDate 1714356333969 Integer 结束时间
shareType 4 Integer 固定值
tranMemberIdsOther Member|409394512313583275 String 固定Member|ID,多个人员以逗号分隔
content aaaaaa String 内容
states 1 Integer 事件完成类型(1.待安排 2.已安排3.处理中 4.已完成)默认:1

# 成功响应示例

{
  "code" : 0,
  "data" : null,
  "message" : ""
}
参数名 示例值 参数类型 参数描述
code 0 Integer 状态码 0为成功
data null Null 日程id
message - String -

# 错误响应示例

{
  "code" : 500,
  "success" : false,
  "message" : null
}
参数名 示例值 参数类型 参数描述
code 500 Integer 失败
success false Boolean -
message null Null -

# 删除日程信息

# 接口URL

http://ip:port/seeyon/rest/event/remove/6506886545006152831?eventId=6506886545006152831&type=0

# 请求方式

POST

# 请求Header参数

参数名 示例值 参数类型 是否必填 参数描述
token 54db786c-d2c2-4240-9474-cec2b41202a4 String 获取token接口中的id

注:请求需要携带token,否则无法使用,获取并传递token方法参考:https://open.seeyoncloud.com/seeyonapi/781/

# 请求Query参数

参数名 示例值 参数类型 是否必填 参数描述
eventId 6506886545006152831 String 日程ID
type 0 String 默认值

# 成功响应示例

true

# 错误响应示例

{
  "code" : 500,
  "success" : false,
  "message" : "该事件已经删除!"
}
参数名 示例值 参数类型 参数描述
code 500 Integer -
success false Boolean -
message 该事件已经删除! String -
创建人:admin
修改人:het、libaoq