캘린터에 일정을 수정합니다.
요청 주소(Request URL)
https://apis.daum.net/calendar/event/update/일정ID.(xml|json)
요청 메소드(Request Method)
POST, GET
인증(Authentication)
OAuth
요청 변수(Request Rarameters)
| 요청변수 | 값 | 설명 |
|---|---|---|
| title | string | 일정의 제목 |
| category_id | integer(필수) | 일정이 속할 카테고리 ID. 값이 없을 경우 기본 카테고리로 일정이 들어갑니다. |
| start_at | string(필수) | 일정의 시작일시. yyyy-mm-dd / yyyy-mm-ddTHH:MM:SS의 형태. 종일 일정의 경우 yyyy-mm-dd까지만 입력하면 됩니다. 예) 2010-03-03 또는 2010-03-03T11:55:00 |
| end_at | string(필수) | 일정의 종료일시. yyyy-mm-dd / yyyy-mm-ddTHH:MM:SS의 형태. 종일 일정의 경우 yyyy-mm-dd까지만 입력하면 됩니다. 예) 2010-03-03 또는 2010-03-03T11:55:00 |
| allday | boolean:(기본값:true) | 종일일정 여부 (true|false) |
| url | string | 일정과 관련된 URL |
| description | string | 일정 설명 |
| attach | string | 일정 이미지 URL |
| uid | string | 일정 제공자가 사용할 수 있는 일정의 고유키. 캘린더에서 global하게 사용하는 key값. 일정의 중복 등록을 피하기 위하여 사용합니다. 입력하지 않으면 다음캘린더 서버에서 임의로 발급합니다. 해당 사용자의 일정 중에 이미 있는 uid의 일정은 생성할 수 없습니다. 가급적 키값으로 일정의 출처를 구분 가능하게 입력하여 주시길 바랍니다. (회사_PK@domain) 예) zzxl0101@daum.net, aaaa0001@google.com, ... |
| rrule | string | 반복 정보와 관련된 룰입니다. RFC2445(ICalendar)의 RRule을 참조하시면 됩니다. 예) FREQ=WEEKLY; |
| exdates | string | 반복 일정일 경우에 사용합니다. rrule에 의해 반복되는 날 일지라도 exdates에 해당하는 날이 있으면 반복에서 제외합니다. 데이터 포멧은 날짜(yyyy-mm-dd)를 (,)로 구분하여 넣어주시면 됩니다. 예)20101212,20101215 |
| location | string | 일정의 위치 |
출력 결과(Response Elements)
| 출력변수 | 값 | 설명 |
|---|---|---|
| event | - | 데이타의 Root Element |
| id | integer | 일정 ID |
| title | string | 일정의 제목 |
| category_id | integer | 일정의 카테고리 ID |
| start_at | string | 일정의 시작일시 (JSON인 경우, 1970년 1월 1일을 기준으로 한 ms값) |
| end_at | string | 일정의 종료일시 (JSON인 경우, 1970년 1월 1일을 기준으로 한 ms값) |
| allday | boolean | 종일일정 여부. 예)true 또는 false |
| url | string | 일정과 관련한 URL |
| description | string | 일정 설명 |
| attach | string | 일정 이미지 URL |
| location | string | 일정의 위치 |
| uid | string | 일정 제공자가 사용할 수 있는 일정의 고유키 |
| repeat | - | 반복 일정인 경우 rrule, exdates 속성의 부모 태그 |
| rrule | string | 반복 룰과 관련된 정보 |
| exdates | string | 예외로 처리 안 하는 날짜 |
출력 예
XML
<?xml version="1.0" encoding="UTF-8"?> <event> <allday>true</allday> <attach/> <category-id>2</category-id> <completed-at nil="true"/> <description/> <end-at>2010-12-14T00:00:00+09:00</end-at> <id>3179</id> <location nil="true"/> <start-at>2010-12-14T00:00:00+09:00</start-at> <title>api_event_test</title> <uid>3520api_test@daum</uid> <url>http://calendar.daum.net </url> <repeat> <rrule>FREQ=YEARLY;</rrule> <id>28</id> <exdates>20111214</exdates> </repeat> </event>
JSON
{
"completed_at":null,
"location":null,
"title":"api_event_test",
"end_at":1292252400000,
"url":"http://calendar.daum.net",
"id":3179,
"start_at":1292252400000,
"uid":"3520api_test@daum",
"attach":"",
"repeat":{"rrule":"FREQ=YEARLY;","id":28,"exdates": "20111214"},
"category_id":2,
"description":"",
"allday":true
}