Mk/fix api docs (#601)

* fix: API URLs for docs

* fix: merge issue

* fix: Lets try this again with some minor changes

backend/app/api/main.go

@@ -69,11 +69,13 @@ func validatePostgresSSLMode(sslMode string) bool {
 // @contact.name               Homebox Team
 // @contact.url                https://discord.homebox.software
 // @host                       demo.homebox.software
+// @schemes                    https http
 // @BasePath                   /api
 // @securityDefinitions.apikey Bearer
 // @in                         header
 // @name                       Authorization
 // @description                "Type 'Bearer TOKEN' to correctly set the API Key"
+// @externalDocs.url 		   https://homebox.software/en/api
 
 func main() {
 	zerolog.ErrorStackMarshaler = pkgerrors.MarshalStack

backend/app/api/static/docs/docs.go

@@ -3265,7 +3265,7 @@ var SwaggerInfo = &swag.Spec{
 	Version:          "1.0",
 	Host:             "demo.homebox.software",
 	BasePath:         "/api",
-	Schemes:          []string{},
+	Schemes:          []string{"https", "http"},
 	Title:            "Homebox API",
 	Description:      "Track, Manage, and Organize your Things.",
 	InfoInstanceName: "swagger",

backend/app/api/static/docs/swagger.json

@@ -1,4 +1,8 @@
 {
+    "schemes": [
+        "https",
+        "http"
+    ],
     "swagger": "2.0",
     "info": {
         "description": "Track, Manage, and Organize your Things.",

backend/app/api/static/docs/swagger.yaml

@@ -2045,6 +2045,9 @@ paths:
       summary: Update Account
       tags:
       - User
+schemes:
+- https
+- http
 securityDefinitions:
   Bearer:
     description: '"Type ''Bearer TOKEN'' to correctly set the API Key"'

docs/docs/api/openapi-2.0.json

@@ -1,4 +1,8 @@
 {
+    "schemes": [
+        "https",
+        "http"
+    ],
     "swagger": "2.0",
     "info": {
         "description": "Track, Manage, and Organize your Things.",

docs/en/api.md

@@ -50,7 +50,7 @@ document.head.appendChild(elementStyle);
 <client-only>
   <elements-api
     :key="componentKey"
-    apiDescriptionUrl="https://cdn.jsdelivr.net/gh/sysadminsmedia/homebox@main/docs/docs/api/openapi-2.0.json"
+    apiDescriptionUrl="https://cdn.jsdelivr.net/gh/sysadminsmedia/homebox@main/docs/docs/api/openapi-2.0.yaml"
     router="hash"
     layout="responsive"
     hideSchemas="true"