Retrieve calendar properties.
Use this command to retrieve the calendar properties for the specified calendars.
The command returns a page with the following X-Tokens containing property information for the specified calendars:
X-NSCP-CALPROPS-ACCESS-CONTROL-ENTRY
X-NSCP-CALPROPS-CALMASTER
X-NSCP-CALPROPS-CATEGORIES
X-NSCP-CALPROPS-CHARSET
X-NSCP-CALPROPS-CHILDREN
X-NSCP-CALPROPS-CREATED
X-NSCP-CALPROPS-DESCRIPTION
X-NSCP-CALPROPS-LANGUAGE
X-NSCP-CALPROPS-LAST-MODIFIED
X-NSCP-CALPROPS-NAME
X-NSCP-CALPROPS-OWNERS
X-NSCP-CALPROPS-PRIMARY-OWNER
X-NSCP-CALPROPS-READ
X-NSCP-CALPROPS-RELATIVE-CALID
X-NSCP-CALPROPS-RESOURCE
X-NSCP-CALPROPS-TZID
X-NSCP-CALPROPS-WRITE
X-S1CS-CALPROPS-ALLOW-DOUBLEBOOKING
X-S1CS-CALPROPS-COMMON-NAME
X-S1CS-CALPROPS-FB-INCLUDE
X-S1CS-CALPROPS-INVITATION-COUNT
If the calendar exists, but the user does not have READ access to it, errno is set to FAILED: ACCESS_DENIED_TO_CALENDAR (28).
If the fetch fails for any calendar, its error number, errno, is set to FAILED: GET_CALPROPS_FAILED (20).
In the following example, you want to retrieve the calendar properties for the calendars jdoe, jsmith, and susan, in that order.
This is the URL:
http://calendarserver/get_calprops.wcap ?id=2mu95r5so0hq68ts6q3 &calid=jdoe;jsmith;susan &fmt-out=text/calendar
This is the returned data:
BEGIN:VCALENDAR PRODID:-//SunJavaSystem/Calendar Hosting Server//EN METHOD:PUBLISH VERSION:2.0 X-NSCP-CALPROPS-LAST-MODIFIED:20030415T001028Z X-NSCP-CALPROPS-CREATED:20030415T001028Z X-NSCP-CALPROPS-READ:999 X-NSCP-CALPROPS-WRITE:999 X-NSCP-CALPROPS-RELATIVE-CALID;X-S1CS-EMAIL=room1a@netscape.com:Room1A X-NSCP-CALPROPS-NAME:Galaxy X-NSCP-CALPROPS-PRIMARY-OWNER:calmaster X-NSCP-CALPROPS-ACCESS-CONTROL-ENTRY:@@o^a^r^g X-NSCP-CALPROPS-ACCESS-CONTROL-ENTRY:@@o^c^wdeic^g X-NSCP-CALPROPS-ACCESS-CONTROL-ENTRY:@^a^rsf^g X-NSCP-CALPROPS-RESOURCE:1 X-S1CS-CALPROPS-ALLOW-DOUBLEBOOKING:1 X-S1CS-CALPROPS-FB-INCLUDE:1 X-S1CS-CALPROPS-COMMON-NAME: Calendar Master X-S1CS-CALPROPS-INVITATION-COUNT: 3 X-NSCP-WCAP-ERRNO:0 END:VCALENDAR