Download API Definitions From API Hub for Design

API Hub for Design lets you download the API definition of any API or domain in the YAML or JSON format.

Download from API Hub for Design Editor

  1. Open the API in the API Hub for Design editor.

  2. If the API has several versions, select the version you want to download.

    API_screenshot_API_versions_01.png
  3. From the Export menu, select Download API, and then select the desired format – YAML or JSON.

    Downloading an API definition as YAML or JSON

There are options to download either a resolved or an unresolved definition. This makes a difference if your definition includes external $ref links, such as links to domains.

  • Unresolved means external links will not be resolved, and the resulting file will contain the $ref links as they appear in the editor.

  • Resolved means external links will resolved, that is, the contents of external files will be included in the resulting definition.

Download via a URL

Public APIs

A quick way to download API definitions from API Hub for Design is to replace app with api in the address bar.

Remove that part if the URL ends with a permalink to a tag or operation, such as #/pets

The download URL has the following format:

https://api.swaggerhub.com/apis/{owner}/{api}/{version}         # API Hub for Design SaaS

You can also use tools like cURL to download definitions from API Hub for Design:

curl https://api.swaggerhub.com/apis/swagger-tutorials/petstore/1.0.0

This downloads the API definition as JSON. If you want YAML, either append /swagger.yaml at the end, or use the Accept: application/yaml header:

curl https://api.swaggerhub.com/apis/swagger-tutorials/petstore/1.0.0/swagger.yaml
curl -H "Accept: application/yaml" https://api.swaggerhub.com/apis/swagger-tutorials/petstore/1.0.0

Resolved YAML/JSON

To get a resolved API definition, append ?resolved=true to the download URL.

Resolved YAML:

https://api.swaggerhub.com/apis/{owner}/{api}/{version}/swagger.yaml?resolved=true

Resolved JSON:

https://api.swaggerhub.com/apis/{owner}/{api}/{version}?resolved=true

Private APIs

If the API definition is private, add the Authorization: API_KEY header containing your API Hub for Design API key:

curl -H "Authorization: API_KEY" https://api.swaggerhub.com/apis/{owner}/{api}/{version}

Maven and Gradle plugins

API Hub for Design has plugins for Maven and Gradle that allow you to download API definitions as part of your CI/CD pipeline.

See Also

Publication date: