Note:

This topic describes how to create a REST project based on an OpenAPI or Swagger definition stored outside of SwaggerHub. If your definition is stored in SwaggerHub, you can import the definition right from SwaggerHub.

To create projects by using an OpenAPI or Swagger definition, follow these steps:

Select File > New Project.

– or –

Use the New Test tile on the Dashboard.

In the Create Project dialog, switch to the Definition tab.
Select Swagger/OpenAPI Definition (REST), specify the project name, the full path to the .yaml or .json specification file and the Default Media Type. You can specify the URL address of the specification or click and select a local definition file.

Click the image to enlarge it.
Click OK.

ReadyAPI will create the project based on your service description.

To learn how to create functional tests from the project, see Creating Functional Tests.

Possible Issues

ReadyAPI cannot import OpenAPI 3.0 specifications through HTTPS if the server where your spec resides has an invalid or expired security certificate. To work around this issue:

Add the following option to the vmoptions file:

-Dio.swagger.parser.v3.util.RemoteUrl.trustAll=true
Restart ReadyAPI to apply the change.

Now you can import your OpenAPI specification.

Next steps

Create a functional test

Create a virtual service from the API

Organize your API

Add more APIs to the project

Creating Project From OpenAPI/Swagger Definition

Possible Issues

Next steps

See Also