support.smartbear.com Open in urlscan Pro
2600:9000:21f3:2800:9:5765:ee00:93a1  Public Scan

Form analysis
0 forms found in the DOM

Text Content

Support
 * 
 * Switch To:
   SmartBear.com
   Open in new tab
   Academy
   Open in new tab
   Community
   Open in new tab
   License Portal
   Open in new tab
   Store
   Open in new tab
   Other SmartBear Tools:




SwaggerHub

SwaggerHub StatusDocumentationCommunityVideosTraining


 * SwaggerHub Documentation
 * About SwaggerHub
 * What's New
 * OpenAPI 3.0 Support
 * AsyncAPI Support
 * Getting Started
 * Editing APIs
 * Managing APIs
 * Domains
 * Integrations
 * Resource Access
 * Account Settings
 * Plans and Billing
 * On-Premise Admin Guide
 * SwaggerHub APIs
 * Reviewing APIs with Confluence
 * Email Notifications
 * IP Addresses
 * FAQ
 * Technical Support

Migrating to Jira Cloud? Join Dec 1st webinar for strategies & tips. Learn more
Join the TestComplete Introductory Training on March 22 to get started with the
product easily
SwaggerHub Documentation
Calling Zephyr Scale users to contribute to the product and community


SWAGGERHUB FAQ

SwaggerHub FAQ
Last modified on April 20, 2023

Here are answers to frequently-asked-questions about SwaggerHub. Don’t see what
you’re looking for? Visit our Community forum.


WHAT IS SWAGGERHUB FOR?

SwaggerHub is an integrated API Development platform, built for teams, that
brings the core capabilities of the Swagger framework to design, build, document
and deploy APIs. SwaggerHub enables development teams to collaborate and
coordinate the entire lifecycle of an API with the flexibility to integrate with
the toolset of your choice.


IS SWAGGERHUB FREE?

APIs make the world a better place for developers, and SwaggerHub has been
designed to allow users to take advantage of a lot of its functionality, for
free. There are premium features which do cost money, and those can be purchased
with a monthly or yearly subscription. You can always downgrade to free if you
want.

To create APIs, you’ll need to create a SwaggerHub account.


BUT I USE GITHUB / BITBUCKET / GITLAB, HOW IS THIS DIFFERENT?

Source control is great for source. But API definitions are not quite the same -
they deserve their own, first-class treatment. SwaggerHub works in conjunction
with version control systems, so hunting through source code should no longer be
necessary.

SwaggerHub does allow connections to GitHub, GitLab, Bitbucket, Azure DevOps
Services, and Azure DevOps Server. See here to learn more about our
integrations.


MY APIS NEED TO BE PRIVATE. WHAT CAN I DO?

Private APIs are available to organizations on paid plans. There are different
plans based on the number of APIs and collaborators you’ll need. You can always
start a free trial to try our various features. Visit the Pricing page for
details on plans and trials.


I WANT TO UPGRADE MY PLAN. WHAT ARE THE PAYMENT OPTIONS AVAILABLE?

We accept payment via Discover, MasterCard, and Visa. For every transaction, you
will receive an email receipt from SwaggerHub to your registered email address.


USING SWAGGERHUB

WHAT BROWSERS CAN I USE WITH SWAGGERHUB?

SwaggerHub and SwaggerHub On-Premise work in the latest versions of:

 * Google Chrome
 * Mozilla Firefox
 * Apple Safari (on macOS only)
 * Microsoft Edge

Other browsers and older versions might work, but they are not officially
supported or tested.

WHAT DOES PUBLISHING AN API DO?

When you create an API and make it available for users to consume, you are
creating a contract for them. They rely on that definition to work a certain
way, and breaking changes will potentially break their integrations.

Publishing an API is specific to a single version of an API. You should do so
when the API ships and users can rely on the signatures. It tells your teams and
consumers that your API is in a stable state. Once published, it is read-only
and cannot be changed.

When published, you should consider making changes in a new version of your API.

After you publish, you may want to update the defaul version of the API. This is
what is shown in search results, or when someone navigates to your API directly
without a specific version number. You can Learn more about versioning.

Of course, there are always unforeseen situations where you may have a typo or
need to make an emergency change. You can Unpublish your API but please do so
carefully. Trust with your users is precious!

Learn more about publishing APIs.

DOES SWAGGERHUB SUPPORT VERSIONING?

Yes, you can version APIs, and deprecate old, outdated API contracts. You can
learn more about versioning here.

WHAT IS THE DIFFERENCE BETWEEN NAME AND TITLE OF AN API?

The Name field of the API is used to uniquely identify the API in SwaggerHub.
Consider this part of a permalink to the API definition. It is also used for
programmatic access to your definition through the SwaggerHub CLI, SwaggerHub
Registry API, and other tools.


COLLABORATION

I NEED TO SHARE MY DEFINITIONS WITH OTHER USERS. HOW IS THIS DONE?

Both public and private definitions can be shared with others easily. These
users are called Collaborators in the system, and can have read-only or
read-write access to an API.

Learn more about collaboration.


IS THERE A LIMIT TO THE NUMBER OF COLLABORATORS I CAN ADD TO MY API?

Yes, the number of collaborators is limited, and is based on the tier you’re in.
Visit the Pricing page for details on the number of collaborators.

HOW CAN I USE SWAGGERHUB WITH MY COMPANY?

SwaggerHub supports the concept of organizations. Each organization can have
teams which will let you add users to logical groups. An API can be given
permissions to individuals or in bulk to teams.

Learn more about organizations.

I NEED TO ACCESS MY DEFINITIONS PROGRAMMATICALLY. HOW DO I DO IT? WHAT IF
THEY’RE PRIVATE?

You can always reach public APIs from the public SwaggerHub API:

https://api.swaggerhub.com

In simple terms, your API definitions can be accessed through this pattern:

https://api.swaggerhub.com/apis/{owner}/{api}/{version}

You can always navigate all your APIs by going here:

https://api.swaggerhub.com/apis/{owner}

This returns a response in the apis.json format.

For protected APIs that you have access to, you can get an API key from
SwaggerHub and use it to access protected API definitions. To retrieve an API
key, go to Settings > API Keys. You can then generate an API key which can be
used as a header when accessing your data. For example:

curl -H Authorization:YOUR_API_KEY https://api.swaggerhub.com/apis/swagger-hub/registry-api/1.0.59

Will return a JSON version of this definition. If you want YAML, tell it with
the Accept header:

curl -H Accept:application/yaml -H Authorization:YOUR_API_KEY https://api.swaggerhub.com/apis/swagger-hub/registry-api/1.0.59

The API key has access to your data, so keep it safe!

I GENERATED A CLIENT SDK. NOW WHAT?

This depends on the language that you’re working with. In general, the client
SDK is not useful on its own- you’ll want to use a program to call it directly.
Each language and framework has different options for usage. Check out the
README.md in the output files - it should help get you started.


INTEGRATIONS

WHAT ARE INTEGRATIONS?

Integrations are free add-ons to your API definition on SwaggerHub to improve
and expand its functionality. These Integrations help connect your API to a host
of third-party tools which allow you to go beyond just API design on SwaggerHub!
You could sync your definition with a GitHub repository, quickly generate a mock
for your OpenAPI definition or create a webhook to trigger for certain events on
SwaggerHub!

Learn more about integrations.

CAN I ADD MULTIPLE INTEGRATIONS TO THE SAME API?

Yes, you can add multiple Integrations to the same API. The Integrations could
be different, for example, an API can have a GitHub Sync and a Webhook
integration enabled. An API can also have the same integrations enabled twice.
For example, two different Amazon API Gateway integrations can be added to the
same API to sync the API with two separate Gateway instances.

DOES API AUTO MOCKING ALLOW FOR ADDING BUSINESS LOGIC?

No, in its current state, the mock generated by API Auto Mocking cannot send
specific responses based on input.


DOMAINS

WHAT ARE DOMAINS?

Any API designer knows that API development involves a lot of reusing and
rewriting definitions and descriptions. Domains are a collection of such
reusable components, which can then be referenced from other APIs and Domains.
Some examples of components that can be stored inside a Domain are:

 * Definitions
 * Path Items
 * Parameters
 * Responses

Users can create and version Domains, and then define the components inside
them. The components can be referenced from other APIs or Domains, either by the
user or the collaborators on the API. Domains can also act as a control center
for multiple APIs. One change in a Domain can quickly transmit the change across
all the APIs which reference the Domain, thus allowing for faster API
development and collaboration.

Learn more about Domains.

WHO CAN VIEW MY DOMAINS?

Domains can have two visibility levels: private and public. As the names
suggest, public Domains can be searched for, viewed, referenced and forked by
other SwaggerHub users, while private Domains can only be viewed and worked on
by you and the collaborators you’ve added.

CAN I REFERENCE OTHER DOMAINS FROM MY DOMAIN?

You can reference your own Domains, public Domains, or private Domains shared
with you by other users. Currently, Domains require absolute references to other
Domains. Just follow the syntax below to reference one Domain from another.

# OpenAPI 3.0
$ref: 'https://api.swaggerhub.com/domains/{owner}/{domainName}/{version}#/components/{componentType}/{componentName}'

# OpenAPI 2.0
$ref: 'https://api.swaggerhub.com/domains/{owner}/{domainName}/{version}#/{componentType}/{componentName}'

HOW CAN I SEARCH FOR OTHER DOMAINS?

Public Domains can be searched, viewed, referenced and forked by other users of
SwaggerHub. Users can use the Type: Domain filter in the search bar to search
for some neat public Domains on SwaggerHub, published by other users.


SEE ALSO

SwaggerHub Documentation

On this page
 * What is SwaggerHub for?
 * Is SwaggerHub free?
 * But I use GitHub / Bitbucket / GitLab, how is this different?
 * My APIs need to be private. What can I do?
 * I want to upgrade my plan. What are the payment options available?
 * Using SwaggerHub
 * Collaboration
 * Is there a limit to the number of collaborators I can add to my API?
 * Integrations
 * Domains


Is this page helpful?
Yes No
Thank you!
Great! Do you have any comments?
1000 characters max
Send Skip
Didn't find an answer?

Ask the community

×Close

 



Explore SmartBear Products
 * AlertSite
 * AQTime Pro
 * BitBar
 * Capture for Jira
 * CrossBrowserTesting

 * Collaborator
 * Cucumber for Jira
 * CucumberStudio
 * LoadNinja

 * ReadyAPI
 * SoapUI
 * Swagger

 * SwaggerHub
 * TestComplete
 * TestEngine
 * TestLeft
 * Zephyr

 * About Us
   |
 * Careers
   |
 * Solutions
   |
 * Partners

--------------------------------------------------------------------------------

 * Contact Us
   |
 * +1 617-684-2600 USA
   |
 * +353 91 398300 EUR
   |
 * +61 391929960 AUS
   |


© 2021 SmartBear Software. All Rights Reserved.

 * Privacy
   |
 * Terms of Use
   |
 * Site Map
   |
 * Website Terms of Use


Highlight search results

Highlight search results Highlight search results

Close
Clear
Documentation
0
Community
0
KnowledgeBase
0
Videos
0
Start typing to perform a search.