search

erasmus-without-paper / ewp-specs-api-omobility-las

Learning Agreements
MIT License
1 stars 2 forks source link

General questions #9

Closed j-be closed 3 years ago

j-be commented 3 years ago

I'm tagging @MartaJuzepczuk and @mkurzydlowski since you are listed as only contributors.

I just recently got the task from my employer, Vienna University of Technology, to implement the EWP APIs. Now, we seem to have been out of the information loop for way to long, so we know nearly nothing about EWP's technical details.

Hence, we looked at the API specs and decided, that the safest place to get our feet wet would be the LearningAgreement APIs, as they seem to offer the least potential for clusterf**k.

We noticed, that the API spec still is not stable, even though they have not been changed for nearly a year. So I have the following questions:

And finally - as said, we know next to nothing - we noticed, that we as Vienna University of Technology can already use the two platforms mentioned above (i.e. https://learning-agreement.eu and https://www.erasmus-dashboard.eu), even though we did nothing to make that happen - as far as we know neither we as SW-Devs, nor the administrative "International office" did. So we still don't fully understand:

Finally, I know that this is maybe the wrong place to ask these questions, but we have been looking for better places to do so, and failed to find anything. So, even if you (i.e. anybody who reads this) maybe can't answer my questions, but know somebody who can (without having to go through some ticket system, and wasting a month or so waiting for a response): I am very thankful for any hint in that direction.

janinamincer-daszkiewicz commented 3 years ago

I know answers to some of the questions:

  1. LA - the stable version will be announced soon, hopefully until the end of January. It will not differ much from the draft available at https://github.com/erasmus-without-paper/ewp-specs-api-omobility-las/tree/new-la-template.

  2. OLA and Dashboard will be the nodes in the EWP Network, so they will also see APIs available in the Network

  3. Anybody can use Dashboard and OLA, I guess that users from Vienna University can be easily recognized by names (but I do not think anybody will share this information with you - GDPR!)

  4. Eventually we will deploy the EWP Registration Portal in which authorised persons from the institution will decide where their APIs are served. The other one (e.g. in the Dashboard) will not be active)

kamil-olszewski-uw commented 3 years ago

Hence, we looked at the API specs and decided, that the safest place to get our feet wet would be the LearningAgreement APIs

In my opinion, it would be much easier to start with Institutions API and Organizational Units API.

j-be commented 3 years ago

@kamil-olszewski-uw agree. To clarify: the safest place to get our feet wet [with read-write APIs] would be the LearningAgreement APIs.

Exposing something somewhere somehow read-only is not much of a "I need to understand how the distributed system is meant to work".

jaros-martin commented 3 years ago

@janinamincer-daszkiewicz Do you have any update on releasing stable version of API for LA? There is a huge time pressure for those who are using in-house systems since it has already become mandatory for upcoming mobilities.

janinamincer-daszkiewicz commented 3 years ago

Almost all envisioned changes are already taken into account in the draft specification, we hope to release the final version any day now, but not later then the end of February.