GET catalog/:year

Returns links to the resources for each semester available in the course catalog for the given year.

Resource URI Example(s)

/catalog/2012

/catalog/2012?mode=links

/catalog/2012?mode=summary

Path Parameter(s)

Parameter Parameter Detail
year required 4-digit year (e.g. 2012, 2011).

Query Parameter(s)

Parameter Value(s)
mode optional links (default value)

Returns links to all semester resources that are scheduled for the given year. This is the default mode and does not have to be specified by the request.

summary

Returns links to all semester resources that are scheduled for the given year and attributes describing the access for these semesters (e.g. publicly viewable and archived).

Example Raw HTTP Request For Links Mode

URL: http://courses.illinois.edu/cisapi/catalog/2012

- OR -

URL: http://courses.illinois.edu/cisapi/catalog/2012?mode=links

Sample HTTP Request Headers

This example shows the query parameter "mode=links" which is the default and can be left off the URL if desired.

1
2
3
4
GET /cisapi/catalog/2012?mode=links HTTP/1.1
User-Agent: YOUR_UA_STRING
Host: courses.illinois.edu
Accept: application/xml

Sample HTTP Response Headers

1
2
3
4
5
HTTP/1.1 200 OK
Date: RESPONSE_TIMESTAMP
Server: OUR_SERVER_STRING
Content-Length: THE_CONTENT_LENGTH
Content-Type: application/xml

Sample HTTP Response Body

1
2
3
4
5
6
7
8
9
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:calendarYear xmlns:ns2="http://rest.cis.illinois.edu" id="2012">
    <label>2012</label>
    <terms>
        <term href="http://courses.illinois.edu/cisapi/catalog/2012/spring" id="120121">Spring 2012</term>
        <term href="http://courses.illinois.edu/cisapi/catalog/2012/fall" id="120128">Fall 2012</term>
        <term href="http://courses.illinois.edu/cisapi/catalog/2012/summer" id="120125">Summer 2012</term>
    </terms>
</ns2:calendarYear>

Example Raw HTTP Request For Summary Mode

URL: http://courses.illinois.edu/cisapi/catalog/2012?mode=summary

Sample HTTP Request Headers

This example shows the query parameter "mode=summary".

1
2
3
4
GET /cisapi/catalog/2012?mode=summary HTTP/1.1
User-Agent: YOUR_UA_STRING
Host: courses.illinois.edu
Accept: application/xml

Sample HTTP Response Headers

1
2
3
4
5
HTTP/1.1 200 OK
Date: RESPONSE_TIMESTAMP
Server: OUR_SERVER_STRING
Content-Length: THE_CONTENT_LENGTH
Content-Type: application/xml

Sample HTTP Response Body

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:calendarYear xmlns:ns2="http://rest.cis.illinois.edu" id="2012">
    <terms>
        <termDetail id="120121" href="http://courses.illinois.edu/cisapi/catalog/2012/spring">
            <label>Spring 2012</label>
            <publicIndicator>Y</publicIndicator>
            <archiveIndicator>N</archiveIndicator>
        </termDetail>
        <termDetail id="120125" href="http://courses.illinois.edu/cisapi/catalog/2012/summer">
            <label>Summer 2012</label>
            <publicIndicator>N</publicIndicator>
            <archiveIndicator>N</archiveIndicator>
        </termDetail>
        <termDetail id="120128" href="http://courses.illinois.edu/cisapi/catalog/2012/fall">
            <label>Fall 2012</label>
            <publicIndicator>N</publicIndicator>
            <archiveIndicator>N</archiveIndicator>
        </termDetail>
    </terms>
</ns2:calendarYear>