予定作成
ログインしたユーザーアカウントの特定のカレンダーに予定を作成します。
APIの種類
サービスAPI
Request URL
https://apis.worksmobile.com/r/{API_ID}/calendar/v2/users/me/calendars/{calendarId}/events
HTTP Method
POST (Content-Type: application/json; charset=UTF-8)
Path Parameters
パラメータ | タイプ | 必須 | 説明 |
---|---|---|---|
calendarId | String | Y | カレンダーID。'defaultCalendarId'を入力すると基本カレンダーに予定が作成されます。 |
Request Body
プロパティ | タイプ | 必須 | 説明 |
---|---|---|---|
ical | String | Y | iCalendarデータ(iCalendarデータ形式を参照) |
Request Example
{
"ical": "BEGIN:VCALENDAR
VERSION:2.0
PRODID:Naver Calendar
CALSCALE:GREGORIAN
BEGIN:VTIMEZONE
TZID:Asia/Seoul
BEGIN:STANDARD
DTSTART:19700101T000000
TZNAME:GMT+09:00
TZOFFSETFROM:+0900
TZOFFSETTO:+0900
END:STANDARD
END:VTIMEZONE
BEGIN:VEVENT
SEQUENCE:0
CLASS:PUBLIC
TRANSP:OPAQUE
UID:6E12DA93-8B43-4576-9A8A-31B4BDC8BDCF_xell_1409882048@example.com
DTSTART;TZID=Asia/Seoul:20140905T110000
DTEND;TZID=Asia/Seoul:20140905T120000
SUMMARY:毎週繰り返しサンプル
DESCRIPTION:詳細説明エリア
LOCATION:ここで
RRULE:FREQ=WEEKLY;BYDAY=FR;INTERVAL=1;UNTIL=20141030T120000
ORGANIZER;CN=山田太郎:mailto:gildong.hong@example.com
ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=NEEDS-ACTION;CN=参加者:mailto:user01@example.com
CREATED:20140905T015408Z
LAST-MODIFIED:20140905T015408Z
DTSTAMP:20140905T015409Z
END:VEVENT
END:VCALENDAR"
}
Response
プロパティ | タイプ | 必須 | 説明 |
---|---|---|---|
result | String | Y | API呼び出し結果 |
code | Integer | Y | HTTPステータスコード |
returnValue | Object | Y | 予定作成に関する情報 |
calendarId | String | Y | カレンダーID |
processType | String | Y | 予定処理タイプ |
icalUid | String | Y | 予定のiCalendar UID |
Response Example
{
"result": "success",
"code": 200,
"returnValue": {
"calendarId": "94e5c541-2f32-4eac-9ce1-0379917314e9",
"processType": "create",
"icalUid": "6E12DA93-8B43-4576-9A8A-31B4BDC8BDCF_xell_1409882048@example.com"
}
}
Error Code
HTTPステータス | エラーコード | 説明 |
---|---|---|
400 | BAD_REQUEST | 不正なリクエスト |
403 | FORBIDDEN | 権限のないリソースへのアクセス |
404 | NOT_FOUND | 対象リソースがない |
409 | CONFLICT | すでにリソースが存在 |
500 | INTERNAL_SERVER_ERROR | 内部エラー |