This document describes all the changes made to the Courses API document, starting from its first beta draft version.
- Updated links and examples.
-
This API now requires implementers to upgrade their implementations to Version 2 of the Authentication and Security document.
In particular, this means that the clients MUST be aware of the fact, that the server is no longer required to support methods of authentication and encryption which it was required to support in the previous versions of this API. Clients SHOULD consult the newly introduced
<http-security>
element in the server's manifest entry before making their requests.
- Make
los-code
s explicitly recommended. - Fix some misspellings.
- Fix schemaLocations.
- Explicitly declare that this version still requires the use of Version 1 of the Authentication and Security document. You can find more information on the planned process of updating security requirements here.
-
Changed XML namespaces (as part of this issue). Since this version, Courses API is in the
stable-v1
XML namespace.This does not means that Courses API is stable. It can still change in backward-incompatible ways, until version
1.0.0
is released. -
The
url
is notmaxOccurs="unbounded"
, and it may have anxml:lang
attribute. See here.
- Fixed annotations. The
<languageOfInstruction>
element is ofxs:language
type, so it's not "ISO 639-1 code" (as it has been mentioned in the annotations), but rather "BCP 47 code". (This is different, because BCP 47 codes may contain various subtags.)
-
Academic Term data type is now in
stable-v1
namespace. -
Added an optional
<ounit-id>
link (more information). -
Introduced limits on LOS and LOI IDs (more information).
-
minOccurs
andmaxOccurs
are now provided explicitly (why?).
-
New
los_code
parameter was added to allow requesters searching for LOSes by their codes (the server is now REQUIRED to support this parameter). Providinglos_id
parameter is no longer required, if the requester provides thelos_code
parameter instead. This is a part of a larger change in all APIs described here. -
New optional element:
<eqfLevelProvided>
. See this issue.
Major changes in the format of LOS and LOI IDs:
- New
LosID
andLoiID
simpleTypes were introduced. - EWP now requires partners to use a predefined set of prefixes for these IDs.
- New
<los-code>
elements were introduced to support servers in providing separate surrogate and natural/business keys for all LOSes.
For discussion and reasoning, see this thread.
- Add
<gradingScheme>
toresponse-example.xml
too.
<gradingScheme>
element has been introduced (issue link).
Initial release.