Accessing information on Academic Terms
:: services/terms module

Basic methods which allow you to retrieve data on Academic Terms defined in this USOS installation. Terms might come in various types, but usually they will be limited to academic years and semesters.

Methods

term Get information on a single term.
terms Get information on multiple terms.
terms_index Get the list of all terms. (administrative)

services/terms/term

Consumer: ignored Token: ignored Scopes: n/a SSL: not required
URLs of the methods are hidden, because this installation is the mother server.
Click here for the list of all public USOS API installations.
Get information on a single term.
term_id required ID of an Academic Term.
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional Required only if you've chosen jsonp as a return format.
No additional OAuth arguments are required. If you provide any, they will be ignored.

Returned value:

A dictionary of the following structure:

  • id - an ID of the term,
  • order_key - long int, used for ordering Academic Term objects (should not be displayed for users),
  • name - a LangDict object with the name of a term,
  • start_date - a Date string, the first day of this Academic Term,
  • end_date - a Date string, the last day of classes in this Academic Term,
  • finish_date - a Date string, the last day of this Academic Term (this day is part of this Academic Term.

Method will end with a 400 error, if referenced term cannot be found.

services/terms/terms

Consumer: ignored Token: ignored Scopes: n/a SSL: not required
URLs of the methods are hidden, because this installation is the mother server.
Click here for the list of all public USOS API installations.
Get information on multiple terms.
term_ids required Pipe-separated list of Academic Term IDs.
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional Required only if you've chosen jsonp as a return format.
No additional OAuth arguments are required. If you provide any, they will be ignored.

Returned value:

A dictionary. Your term_ids will be mapped to the keys of this dictionary, each value will contain a dictionary describing a term (as defined in the term method). If term does not exist, it's key will be mapped to null.

services/terms/terms_index

Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: not required
URLs of the methods are hidden, because this installation is the mother server.
Click here for the list of all public USOS API installations.

Get the list of all Academic Terms defined in this installation.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Token is not required.

Returned value:

The list of dictionaries, each dictionary describes one term (as defined in the term method. Returned items will be ordered by their order_key (ascending).

USOS API ver. 6.1.2.0-bc1aa53 (2016-06-07)