-
Demo https://staging.madek.zhdk.ch/ -> https://staging.madek.zhdk.ch/api/browser/
-
für Login den Support anfragen https://wiki.zhdk.ch/medienarchiv/doku.php#support_per_e-mail Referenz API Projekt HfG
-
REST
-
Entstehung 2015,
- technischer Stand von 2015: Browser 😊
- Tooling z.B. JSON-ROA von Damals und entspechend veraltet
-
verfügbare Resourcen:
- Schwerpunkt MetaDaten (nicht schreibbar)
- Zugriff auf Originale und Ableitungen (Previews)
- später zugefügt: Benutzer, Gruppen (Eingeschränkt, teilweise Schreibbar)
-
alte API nicht erweitern, bleibt nebenher als lange wie möglich unter
/api/bestehen -
neue API, neues Projekt, neuer Service, getrennter Pfad:
/apiv2(oder scope/meta-api, oder ....) -
REST vs GraphML: REST
- im prinzip ähnliche resourcen Struktur wie bestehende API
- später bei bedarf erweitern: z.B. Resourcen für massenupdates, tiefere Verschachtlung, wenn unbedingt nötig GraphML
-
Platform & Programmiersprache: JVM, Clojure mit aktuellem Tooling
- ZHdK kann das integrieren und ggf später übernehmen
- von der alten API können Teile mit etwas anpassung übernommen werden, z.B. Berechtigungs Queries (komplex !)
- aktuelles Projekt https://github.com/Madek/madek-media-service kann als Template verwendet werden
- API Dokumentation https://swagger.io/ "OpenAPI"
-
Session Verwaltung (Passwörter und Verwandtes) ist veraltet; wird erneuert;
- eventuell kombiniert mit eingener API zur Verwaltung von Benutzer, Gruppen und vor allem Authentisierung
- -> Benutzer und Gruppen würde ich aussen vor lassen
- -> Vorerst Session Handling von https://github.com/Madek/madek-media-service übernhemen
- versuche das Zeitnah, also parallel einzubringen
-
Medien Handling wird erneuert
- wird frühestens Ende 2023 einsetzbar sein, einführung vermutlich erst Mitte 2024
- -> hier nicht viel investieren; "Redirekt fest" wäre gut