添加个人日程

接口说明

请求URL：http[s]://{网关地址}/casp-cal/createPersonCal

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求头

字段名	参数名	必填	类型	描述
应用ID	appId	M	String(128)	接入网关的应用ID
Token	accessToken	M	String	接入网关的accessToken

请求体

字段名	参数名	必填	类型
日程标题	eventTitle	M	String(100)
是否是全天日程 1：是 0：否	isAllDay	M	int
单个日程开始时间 isAllDay 为0是 格式yyyy-MM-dd HH:mm:ss 1:yyyy-MM-dd	startTime	M	String(20)
单个日程结束时间（格式同上）	endTime	M	String(20)
日程地址	eventAddr	O	String(100)
日程描述	eventDesc	O	String(1000)
链接地址	linkUrl	O	String(1024)
日程重复类型 0不重复 1每天 2每周 3每月第N天 4每年 5(按月-周重复) 第n周的n个星期几	eventRepeatType	M	int
重复间隔(重复类型时这个必填)，	eventRepeatData	O	int
日程开始前多久提醒（json数组）单位分钟 全天日程的提醒时间 （-540，当天9点），（900，一天前9点），（2340， 2天前9点），（9540，一周前9点） 非全天日程的提醒时间（0，开始时），（5，5分钟前），（15，15分钟前），（30，30分钟前），（60，1小时前）, (1440, 一天前)	remindTimes	O	List<long>
用户工号	userAccount	M	String(20)
提醒通道当提醒时间不为空时，这个必填,多个用,分割 INBOX 收件箱 CAMPUSHOY 今日校园 EMAIL 邮箱 SMS 短信 QYWECHAT 企业微信 DINGTALK 钉钉 WeChatService 微信服务号 WELINK 华为weilink	remindChannel	O	String(64)
日程截止时间 格式:yyyy-MM-dd（只有重复类型 且 rangeType 是 endDate）	deadline	O	String(10)
英文小写单词指定星期几，如果有多个值逗号分割。eventRepeatType 为3时使用,可以传多个；eventRepeatType 为5时使用,只能传1个	dayOfWeek	O	String
当重复类型是5，用于指定每月第几周（first second third fourth last ） eventRepeatType 为5时使用	weekIndex	O	String(1)
循环范围类型： noEnd：永不结束 endDate：循环至指定日期结束 numbered：循环指定次数后结束	rangeType	O	String(8)
循环次数(rangTye 是numbered )	rangeNum	O	int

请求示例

普通不重复

{
  "eventTitle":"zjs8月31普通日程",
  "startTime":"2022-08-31 00:00:00",
  "endTime":"2022-08-31 00:00:00",
  "eventAddr":"12323",
  "eventDesc":"描述",
  "linkUrl":"http://www.baidu.com",
  "eventRepeatType":0,
  "eventRepeatData":1,
  "remindTimes":[15],

  "userAccount":"ampadmin",
  "remindChannel":"INBOX,CAMPUSHOY",
  "isAllDay":0

}

创建个人 每10天重复

{
  "eventTitle":"zjs09-01 每10天重复日程",
  "startTime":"2022-09-01 00:00:00",
  "endTime":"2022-09-01 00:00:00",
  "eventAddr":"12323",
  "eventDesc":"描述",
  "linkUrl":"http://www.baidu.com",
  "eventRepeatType":1,
  "eventRepeatData":10,
  "remindTimes":[15],

  "userAccount":"ampadmin",
  "remindChannel":"INBOX",
  "isAllDay":0

}

创建个人 每周56重复

{
    "eventTitle":"zjs09-01 每周56重复",
    "startTime":"2022-09-01 00:00:00",
      "endTime":"2022-09-01 00:00:00",
     "eventAddr":"12323",
      "eventDesc":"描述",
       "linkUrl":"http://www.baidu.com",
   "eventRepeatType":2,
       "eventRepeatData":1,
       "remindTimes":[15],

          "userAccount":"ampadmin",
"remindChannel":"INBOX",
"isAllDay":0,
"dayOfWeek":"friday,saturday"

}

创建个人 每月 重复

    {
        "eventTitle":"zjs09-01 每月重复",
        "startTime":"2022-09-01 00:00:00",
        "endTime":"2022-09-01 00:00:00",
        "eventAddr":"12323",
        "eventDesc":"描述",
        "linkUrl":"http://www.baidu.com",
    "eventRepeatType":3,
        "eventRepeatData":1,
        "remindTimes":[15],
   
            "userAccount":"ampadmin",
    "remindChannel":"INBOX",
    "isAllDay":0

    }

创建个人 每年

    {
        "eventTitle":"zjs09-01 每年重复",
        "startTime":"2022-09-01 00:00:00",
        "endTime":"2022-09-01 00:00:00",
        "eventAddr":"12323",
        "eventDesc":"描述",
        "linkUrl":"http://www.baidu.com",
    "eventRepeatType":4,
        "eventRepeatData":1,
        "remindTimes":[15],
   
            "userAccount":"ampadmin",
    "remindChannel":"INBOX",
    "isAllDay":0

    }

创建个人 每月 第N周星期一

    {
        "eventTitle":"zjs09-01 每年重复",
        "startTime":"2022-09-01 00:00:00",
        "endTime":"2022-09-01 00:00:00",
        "eventAddr":"12323",
        "eventDesc":"描述",
        "linkUrl":"http://www.baidu.com",
    "eventRepeatType":5,
        "eventRepeatData":1,
        "remindTimes":[15],
 
            "userAccount":"ampadmin",
    "remindChannel":"INBOX",
    "isAllDay":0,
    "weekIndex":"first",
    "dayOfWeek":"monday"

    }

响应说明

响应体

字段名	参数名	必填	类型	描述
返回码	errcode	M	String	0 成功，其他为不成功
返回码描述	errmsg	O	String	返回码描述

响应示例

{
  "errcode": "0",
  "errmsg": "success"
}

错误码

错误码	描述
999	统一错误码，详细描述信息参见接口返回

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID,APP_SECRET);

// 创建请求对象
CreatePersonCalRequest request = new CreatePersonCalRequest();
request.setEventTitle("8月1日test");
request.setStartTime("2024-08-01 09:00:00");
request.setEndTime("2024-08-01 11:00:00");
request.setEventAddr("12323");
request.setEventDesc("测试个人日程");
request.setLinkUrl("http://www.baidu.com");
request.setEventRepeatType(EventRepeatType.EVENT_REPEAT_TYPE_0);
request.setEventRepeatData(1);
request.setRemindTimes(Arrays.asList(Long.valueOf("15")));
request.setUserAccount("ampadmin");
request.setRemindChannel(EventRemindChannel.INBOX);
request.setIsAllDay(0);
BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
    //.....
}