GET /v1/calendar/events/{id}/occurrences

Returns occurrences of a recurring event specified by id, in one of conditions: the calendar of the event is public, OR the authenticated user is the owner of the calendar, OR the user belongs to the group of the calendar, OR the user is a participant of the event, OR the calendar has been shared with the user or with a group of the user.

URL:

http://{domain_name}/{rest_context_name}/private/v1/calendar/events/{id}/occurrences

Supported Format: JSON

Parameters:

  • Required (path parameters):

Parameter Description
id Identity of the event.
  • Optional (query parameters):

Parameter Description
offset The starting point when paging the result. Default is 0.
limit Maximum number of occurrences returned. If omitted or exceeds the query limit parameter configured for the class, query limit is used instead.
start Date complies ISO8601 (YYYY-MM-DDThh:mm:ssTZD). Search for occurrences from this date. Default: current server time.
end Date complies ISO8601 (YYYY-MM-DDThh:mm:ssTZD). Search for occurrences to this date. Default: current server time + 1 week.
fields Comma-separated list of selective attributes to be returned. All returned if not specified.
jsonp The name of a JavaScript function to be used as the JSONP callback. If not specified, only JSON object is returned.
expand Used to ask for more attributes of a sub-resource, instead of its link only. This is a comma-separated list of property names. For example: expand=calendar,categories. In case of collections, you can specify offset (default: 0), limit (default: querylimit ). For example, expand=categories(1,5). Instead of: { "calendar": "http://localhost:8080/rest/private/v1/calendar/calendars/john-defaultCalendarId", } It returns: { "calendar": { "editPermission": "", "viewPermission": "", "privateURL": null, "publicURL": null, "icsURL": "http://localhost:8080/rest/private/v1/calendar/calendars/john-defaultCalendarId/ics", "description": null, "color": "asparagus", "timeZone": "Europe/Brussels", "name": "John Smith", "type": "0", "owner": "john", "groups": null, "href": "http://localhost:8080/rest/private/v1/calendar/calendars/john-defaultCalendarId", "id": "john-defaultCalendarId" }, }
returnSize Default is false. If set to true, the total number of matched calendars will be returned in JSON, and a "Link" header is added. This header contains "first", "last", "next" and "previous" links.

Request example:

 {@code GET: http://localhost:8080/rest/private/v1/calendar/events/Event123/occurences?offset=1&limit=5}

Response:

 {
   "limit": 0,
   "data": [
     {
       "to": "2015-07-24T02:30:00.000Z",
       "attachments": [],
       "from": "2015-07-24T02:00:00.000Z",
       "categories": [
         "http://localhost:8080/rest/private/v1/calendar/categories/defaultEventCategoryIdAll"
       ],
       "categoryId": "defaultEventCategoryIdAll",
       "availability": "busy",
       "repeat": {},
       "reminder": [],
       "privacy": "private",
       "recurrenceId": null,
       "participants": [],
       "originalEvent": null,
       "description": null,
       "calendar": "http://localhost:8080/rest/private/v1/calendar/calendars/john-defaultCalendarId",
       "subject": "rep123",
       "location": null,
       "priority": "none",
       "href": "http://localhost:8080/rest/private/v1/calendar/events/Eventaa3c68ee7f00010171ac205a54bc1419",
       "id": "Eventaa3c68ee7f00010171ac205a54bc1419"
     },
     {}
   ],
   "size": -1,
   "offset": 10
 }

Copyright ©2015. All rights reserved. eXo Platform SAS
blog comments powered byDisqus