@backstage/plugin-api-docs 0.0.0-nightly-20260409031723 → 0.0.0-nightly-20260410031841

package/CHANGELOG.md

@@ -1,19 +1,20 @@
 # @backstage/plugin-api-docs
 
-## 0.0.0-nightly-20260409031723
+## 0.0.0-nightly-20260410031841
 
 ### Patch Changes
 
+- da17844: Update readme to add instructions for custom api base URL
 - Updated dependencies
-  - @backstage/ui@0.0.0-nightly-20260409031723
-  - @backstage/plugin-catalog@0.0.0-nightly-20260409031723
-  - @backstage/core-components@0.0.0-nightly-20260409031723
-  - @backstage/plugin-catalog-react@0.0.0-nightly-20260409031723
-  - @backstage/frontend-plugin-api@0.0.0-nightly-20260409031723
-  - @backstage/catalog-model@0.0.0-nightly-20260409031723
-  - @backstage/core-plugin-api@0.0.0-nightly-20260409031723
-  - @backstage/plugin-catalog-common@0.0.0-nightly-20260409031723
-  - @backstage/plugin-permission-react@0.0.0-nightly-20260409031723
+  - @backstage/ui@0.0.0-nightly-20260410031841
+  - @backstage/plugin-catalog@0.0.0-nightly-20260410031841
+  - @backstage/core-components@0.0.0-nightly-20260410031841
+  - @backstage/plugin-catalog-react@0.0.0-nightly-20260410031841
+  - @backstage/frontend-plugin-api@0.0.0-nightly-20260410031841
+  - @backstage/catalog-model@0.0.0-nightly-20260410031841
+  - @backstage/core-plugin-api@0.0.0-nightly-20260410031841
+  - @backstage/plugin-catalog-common@0.0.0-nightly-20260410031841
+  - @backstage/plugin-permission-react@0.0.0-nightly-20260410031841
 
 ## 0.13.6-next.2
 

package/README.md

@@ -340,6 +340,34 @@ import { ApiExplorerPage } from '@backstage/plugin-api-docs';
 />;
 ```
 
+## Troubleshooting
+
+### "Try it out" sends requests to the wrong host
+
+If the **Try it out** feature in the OpenAPI widget sends requests to your Backstage app's URL instead of the actual API host, the OpenAPI spec is missing a `servers` entry.
+When no `servers` field is present, Swagger UI falls back to `window.location.origin` — the current page's host — as the base URL for all requests.
+
+**Fix**: add a `servers` field to your API entity's `spec.definition`:
+
+```yaml
+# catalog-info.yaml
+apiVersion: backstage.io/v1alpha1
+kind: API
+metadata:
+  name: my-api
+spec:
+  type: openapi
+  definition: |
+    openapi: "3.0.0"
+    info:
+      title: My API
+      version: v1
+    servers:
+      - url: https://api.example.com/v1   # ← specify your api base URL
+```
+
+If you cannot modify the spec (e.g. it is generated or fetched from an external source), you can work around this by adding a `requestInterceptor` that rewrites the URL — see [Adding `requestInterceptor` to Swagger UI](#adding-requestinterceptor-to-swagger-ui) above.
+
 ## Old Frontend System
 
 If your Backstage app uses the old frontend system, you need to manually wire the plugin into your app as outlined in this section. If you are on the new frontend system, you can skip this.

package/dist/package.json.esm.js

@@ -1,5 +1,5 @@
 var name = "@backstage/plugin-api-docs";
-var version = "0.0.0-nightly-20260409031723";
+var version = "0.0.0-nightly-20260410031841";
 var description = "A Backstage plugin that helps represent API entities in the frontend";
 var backstage = {
 	role: "frontend-plugin",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-api-docs",
-  "version": "0.0.0-nightly-20260409031723",
+  "version": "0.0.0-nightly-20260410031841",
   "description": "A Backstage plugin that helps represent API entities in the frontend",
   "backstage": {
     "role": "frontend-plugin",
@@ -66,15 +66,15 @@
   },
   "dependencies": {
     "@asyncapi/react-component": "^2.3.3",
-    "@backstage/catalog-model": "0.0.0-nightly-20260409031723",
-    "@backstage/core-components": "0.0.0-nightly-20260409031723",
-    "@backstage/core-plugin-api": "0.0.0-nightly-20260409031723",
-    "@backstage/frontend-plugin-api": "0.0.0-nightly-20260409031723",
-    "@backstage/plugin-catalog": "0.0.0-nightly-20260409031723",
-    "@backstage/plugin-catalog-common": "0.0.0-nightly-20260409031723",
-    "@backstage/plugin-catalog-react": "0.0.0-nightly-20260409031723",
-    "@backstage/plugin-permission-react": "0.0.0-nightly-20260409031723",
-    "@backstage/ui": "0.0.0-nightly-20260409031723",
+    "@backstage/catalog-model": "0.0.0-nightly-20260410031841",
+    "@backstage/core-components": "0.0.0-nightly-20260410031841",
+    "@backstage/core-plugin-api": "0.0.0-nightly-20260410031841",
+    "@backstage/frontend-plugin-api": "0.0.0-nightly-20260410031841",
+    "@backstage/plugin-catalog": "0.0.0-nightly-20260410031841",
+    "@backstage/plugin-catalog-common": "0.0.0-nightly-20260410031841",
+    "@backstage/plugin-catalog-react": "0.0.0-nightly-20260410031841",
+    "@backstage/plugin-permission-react": "0.0.0-nightly-20260410031841",
+    "@backstage/ui": "0.0.0-nightly-20260410031841",
     "@graphiql/react": "0.29.0",
     "@material-ui/core": "^4.12.2",
     "@material-ui/icons": "^4.9.1",
@@ -86,11 +86,11 @@
     "swagger-ui-react": "^5.27.1"
   },
   "devDependencies": {
-    "@backstage/cli": "0.0.0-nightly-20260409031723",
-    "@backstage/core-app-api": "0.0.0-nightly-20260409031723",
-    "@backstage/dev-utils": "0.0.0-nightly-20260409031723",
-    "@backstage/frontend-test-utils": "0.0.0-nightly-20260409031723",
-    "@backstage/test-utils": "0.0.0-nightly-20260409031723",
+    "@backstage/cli": "0.0.0-nightly-20260410031841",
+    "@backstage/core-app-api": "0.0.0-nightly-20260410031841",
+    "@backstage/dev-utils": "0.0.0-nightly-20260410031841",
+    "@backstage/frontend-test-utils": "0.0.0-nightly-20260410031841",
+    "@backstage/test-utils": "0.0.0-nightly-20260410031841",
     "@testing-library/dom": "^10.0.0",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",