From 2742ecd3afdb47828362fb9fc8516c877aa3b7b7 Mon Sep 17 00:00:00 2001
From: gerardishare <gerard.huisintveld@ishare.eu>
Date: Tue, 17 Jun 2025 15:21:30 +0200
Subject: [PATCH 1/4] Add Swagger UI website with version selector

---
 index.html | 104 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 index.html
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..cb1da45
--- /dev/null
+++ b/index.html
@@ -0,0 +1,104 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>iSHARE API Documentation</title>
+    <link rel="stylesheet" type="text/css" href="https://unpkg.com/swagger-ui-dist@5.11.0/swagger-ui.css">
+    <style>
+        body {
+            margin: 0;
+            padding: 0;
+        }
+        #version-selector {
+            position: fixed;
+            top: 0;
+            right: 0;
+            z-index: 1000;
+            padding: 15px 20px;
+            background: #1b1b1b;
+            color: #fff;
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+            font-size: 14px;
+            display: flex;
+            align-items: center;
+            border-bottom-left-radius: 4px;
+        }
+        #version-selector label {
+            margin-right: 10px;
+            color: #fff;
+        }
+        #version-selector select {
+            padding: 6px 10px;
+            border: 1px solid #41444e;
+            border-radius: 4px;
+            background-color: #2b2b2b;
+            color: #fff;
+            font-size: 14px;
+            cursor: pointer;
+            outline: none;
+            transition: border-color 0.2s;
+        }
+        #version-selector select:hover {
+            border-color: #4990e2;
+        }
+        #version-selector select:focus {
+            border-color: #4990e2;
+            box-shadow: 0 0 0 2px rgba(73, 144, 226, 0.2);
+        }
+        #version-selector select option {
+            background-color: #2b2b2b;
+            color: #fff;
+        }
+    </style>
+</head>
+<body>
+    <div id="version-selector">
+        <label for="version">API Version:</label>
+        <select id="version" onchange="changeVersion()">
+            <option value="main">Current Version (2.2)</option>
+            <option value="v2.1">v2.1</option>
+            <option value="v2.0.1">v2.0.1</option>
+            <!-- Add more versions as needed -->
+        </select>
+    </div>
+    <div id="swagger-ui"></div>
+
+    <script src="https://unpkg.com/swagger-ui-dist@5.11.0/swagger-ui-bundle.js"></script>
+    <script src="https://unpkg.com/swagger-ui-dist@5.11.0/swagger-ui-standalone-preset.js"></script>
+    <script>
+        const versions = {
+            'main': 'https://github.com/iSHAREScheme/openapi/blob/main/ishare_openapi_spec.yaml',
+            'v2.1': 'https://github.com/iSHAREScheme/openapi/blob/v2.1/ishare_openapi_spec.yaml',
+            'v2.0(.1)': 'https://github.com/iSHAREScheme/openapi/blob/v2.0/ishare_openapi_spec.yaml'
+        };
+
+        function initSwaggerUI(url) {
+            window.ui = SwaggerUIBundle({
+                url: url,
+                dom_id: '#swagger-ui',
+                deepLinking: true,
+                presets: [
+                    SwaggerUIBundle.presets.apis,
+                    SwaggerUIStandalonePreset
+                ],
+                plugins: [
+                    SwaggerUIBundle.plugins.DownloadUrl
+                ],
+                layout: "StandaloneLayout"
+            });
+        }
+
+        function changeVersion() {
+            const version = document.getElementById('version').value;
+            const url = versions[version];
+            if (url) {
+                initSwaggerUI(url);
+            }
+        }
+
+        // Initialize with main version
+        initSwaggerUI(versions['main']);
+    </script>
+</body>
+</html> 
\ No newline at end of file

From c0f8238613235c1e4b62e07047a61742512c3df4 Mon Sep 17 00:00:00 2001
From: gerardishare <gerard.huisintveld@ishare.eu>
Date: Tue, 17 Jun 2025 15:30:50 +0200
Subject: [PATCH 2/4] Point to raw files

---
 index.html | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/index.html b/index.html
index cb1da45..0e38bed 100644
--- a/index.html
+++ b/index.html
@@ -68,9 +68,9 @@
     <script src="https://unpkg.com/swagger-ui-dist@5.11.0/swagger-ui-standalone-preset.js"></script>
     <script>
         const versions = {
-            'main': 'https://github.com/iSHAREScheme/openapi/blob/main/ishare_openapi_spec.yaml',
-            'v2.1': 'https://github.com/iSHAREScheme/openapi/blob/v2.1/ishare_openapi_spec.yaml',
-            'v2.0(.1)': 'https://github.com/iSHAREScheme/openapi/blob/v2.0/ishare_openapi_spec.yaml'
+            'main': 'https://raw.githubusercontent.com/iSHAREScheme/openapi/main/ishare_openapi_spec.yaml',
+            'v2.1': 'https://raw.githubusercontent.com/iSHAREScheme/openapi/v2.1/ishare_openapi_spec.yaml',
+            'v2.0(.1)': 'https://raw.githubusercontent.com/iSHAREScheme/openapi/v2.0/ishare_openapi_spec.yaml'
         };
 
         function initSwaggerUI(url) {

From e5a176b3352090ba5ed30dbde5cd94a9452cad6a Mon Sep 17 00:00:00 2001
From: gerardishare <gerard.huisintveld@ishare.eu>
Date: Tue, 17 Jun 2025 15:37:12 +0200
Subject: [PATCH 3/4] Update readme file to reflect new approach

---
 README.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 1ea6f60..259640b 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,5 @@
-# iSHARE OpenAPI specifications
-This repository contains OpenAPI specifications for iSHARE roles. The final and most recent versions are published on [Swaggerhub](https://app.swaggerhub.com/apis/iSHARE). This repository is kept for versioning purposes.
+# iSHARE OpenAPI Specifications
 
-TO-DO:
-- Reconsider all identity provider endpoints and implement in this openapi spec
-- Define userinfo_token
\ No newline at end of file
+This repository contains OpenAPI specifications for iSHARE roles. It publishes the yaml files as github page for reference. The yaml files are also included in the [iSHARE Developer Portal](https://dev.ishare.eu).
+
+For more information about iSHARE, got to [https://www.ishare.eu].
\ No newline at end of file

From 9ab0dccc760131e39e43deffce36d25c6de553c6 Mon Sep 17 00:00:00 2001
From: gerardishare <gerard.huisintveld@ishare.eu>
Date: Tue, 17 Jun 2025 15:46:35 +0200
Subject: [PATCH 4/4] Minor fix

---
 index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index 0e38bed..9e7bed5 100644
--- a/index.html
+++ b/index.html
@@ -58,7 +58,7 @@
         <select id="version" onchange="changeVersion()">
             <option value="main">Current Version (2.2)</option>
             <option value="v2.1">v2.1</option>
-            <option value="v2.0.1">v2.0.1</option>
+            <option value="v2.0">v2.0(.1)</option>
             <!-- Add more versions as needed -->
         </select>
     </div>
@@ -70,7 +70,7 @@
         const versions = {
             'main': 'https://raw.githubusercontent.com/iSHAREScheme/openapi/main/ishare_openapi_spec.yaml',
             'v2.1': 'https://raw.githubusercontent.com/iSHAREScheme/openapi/v2.1/ishare_openapi_spec.yaml',
-            'v2.0(.1)': 'https://raw.githubusercontent.com/iSHAREScheme/openapi/v2.0/ishare_openapi_spec.yaml'
+            'v2.0': 'https://raw.githubusercontent.com/iSHAREScheme/openapi/v2.0/ishare_openapi_spec.yaml'
         };
 
         function initSwaggerUI(url) {
