如何将现有OpenAPI定义导入SwaggerHub？含Swagger UI链接导入问题

1. How to import an existing OpenAPI definition into SwaggerHub? #

SwaggerHub offers a few straightforward ways to bring in your existing OpenAPI (Swagger) definitions—here are the most reliable methods:

• Upload a local file:
  1. Log into your SwaggerHub account and head to the workspace where you want to add the API.
  2. Click Create New API (or pick an existing API if you want to update it).
  3. On the setup screen, look for the Import option (right near the API definition editor).
  4. Select Upload File, then choose your OpenAPI YAML or JSON file from your local machine. SwaggerHub will parse the file and populate the API definition automatically.
• Paste raw definition content:
  If you have the OpenAPI YAML/JSON code copied to your clipboard, skip the file upload and select Paste instead. Paste the raw code into the provided field, and SwaggerHub will validate and load it right away.
• Import from a Git repository:
  If your definition lives in a Git repo (GitHub, GitLab, Bitbucket, etc.), select Import from Git. Enter the repository URL, specify the target branch, and the exact path to your OpenAPI file in the repo. SwaggerHub can even set up auto-sync to pull updates from the repo on a regular basis.

2. Can I import an OpenAPI definition via a Swagger UI page link? And why isn't my WEBLoc file link working? #

To cut to the chase: SwaggerHub can't directly import from a Swagger UI page URL. Swagger UI is just a web interface that renders the OpenAPI definition—it doesn't host the raw YAML/JSON file itself. To import via a URL, you need the direct link to the raw OpenAPI definition file (YAML or JSON format).

As for your WEBLoc file issue: WEBLoc files are Apple-specific shortcut files that point to a web URL, but SwaggerHub doesn't recognize or parse these files. Here's how to fix this:

1. Open the WEBLoc file to get the actual URL it links to (this is almost always a Swagger UI page).
2. On that Swagger UI page, look for a Download button (usually labeled "Download JSON" or "Download YAML")—this gives you access to the raw definition file.
3. Either download the file and use the "Upload File" method from question 1, or copy the direct URL to the raw file (make sure it's publicly accessible) and use SwaggerHub's Import from URL option (found in the import menu) to pull it in directly.

Note: SwaggerHub can't fetch files behind authentication walls or paywalls, so the raw file URL needs to be publicly reachable.

内容的提问来源于stack exchange，提问作者user9564670