This document describes the Outgoing Mobility Learning Agreements API. This API is implemented by the sending institution. It allows the receiving HEI to read and accept Learning Agreements stored on the sending HEI's servers and propose changes to them.
This API is based on the new LA template. The most recent version is available on the EUF Wiki.
Keep in mind that definitions of "sending HEI" and "receiving HEI" come from the "mobility vocabulary", not the "HTTP vocabulary". In case of this particular API this means that:
- sending HEI == responding HEI (HEI which is sending the student == HEI which implements the API, receives the HTTP request, and responds to it),
- receiving HEI == requesting HEI (HEI which is receiving the student == HEI which implements the client, and sends the HTTP request).
As long as we use these terms consistently, there shouldn't be much confusion though.
This version of this API uses standard EWP Authentication and Security, Version 2. Server implementers choose which security methods they support by declaring them in their Manifest API entry.
This API handles data which is considered private. Server implementers are allowed to forbid less-secure methods of authentication and encryption for this API (by dropping support for them). Currently, we leave it for the server implementers to decide which methods are "secure enough". These recommendations MAY change in the future.
Server implementers MUST:
- Implement the
getendpoint. - Implement the
indexendpoint. - Implement the
updateendpoint. - Put the URLs of these endpoints in their manifest file, as described in manifest-entry.xsd.
The details on each of these endpoints are described on separate pages of this API specification (use the links above).
Implementers also MUST implement a Notification Sender for Learning Agreement objects. That means that an EWP host will try to deliver notifications to all Outgoing Mobility Learning Agreement CNR APIs implemented throughout the EWP Network whenever related mobility objects are updated.
The Learning Agreement, which was initially part of the Outgoing Mobilities API, has been separated into the Outgoing Mobility Learning Agreements API. However, the learning agreement object is still identified by the mobility identifier (omobility_id). If the HEI implements both the Outgoing Mobilities API and the Outgoing Mobility Learning Agreements (which we encourage), then it must ensure that every learning agreement object will have the same identifier as the corresponding outgoing mobility objects served by the Outgoing Mobilities API.
- Mobility
- Person
- Coordinator
- IIA Partner
- Learning Agreement
- Learning Agreement Component
- Learning Opportunity Specification
- Learning Opportunity Instance
- Academic Term