Import GraphQL API Definitions
You can upload your existing GraphQL API definitions to SwaggerHub by implementing the standard API importing features. The imported queries are then displayable and searchable in your organization's API catalog.
Using Registry API or the SwaggerHub interface, you can not only add new GraphQL definitions, but also overwrite or export the existing ones.
Import a GraphQL definition
All GraphQL queries must be imported as .graphql or .gql files. Note that the .json format is not supported for this specification. Both owners and designers can import GraphQL APIs to their organization.
To import a GraphQL definition using the SwaggerHub interface, perform the following steps:
On the SwaggerHub landing page, select the Import API tile.
Alternatively, click Create New in the left sidebar and select Import and Document API.
In the new dialog, click Browse and paste the link or choose the file containing the GraphQL collection you want to import.
After SwaggerHub has validated the selected collection as a correct
.graphqlor.gqlfile, specify the name and version of the definition you want to create..
Name – The API name is its unique ID and is part of its path on SwaggerHub, as in https://app.swaggerhub.com/api/{OwnerID}/petstore/1.0. Requirements:
3 to 60 character long
Allowed characters:
A..Z a..z 0..9 - _ .Must start and end with a letter or digit
Note that API names are case-sensitive, so petstore and PetStore are two different APIs.
Tip
To import the definition as a new version of an existing API, enter the name of the existing API.
Version – The version of the imported API. It is specified in the
info.versionfield of the definition.
Select Import definition to complete the process.
Browse GraphQL definitions
The imported GraphQL files are listed in your organization's My APIs page. In the main catalog, you can view the following attributes of these definitions:
Name
Resource type
Specification type
To easily navigate to your GraphQL APIs, enter their attributes in the search field.
Similar to other API specifications, you can also add GraphQL definitions to your organization's projects.
Display or export a GraphQL definition
After importing a GraphQL definition or navigating to it from your organization's catalog, the API is displayed in detail. Note that SwaggerHub does not support this API format's edition.
You can download your GraphQL definition as a file matching the format of the original import. To initiate the download, select the Export option available on the toolbar.
