Creating Project From OpenAPI/Swagger Definition
This topic describes how to create a REST project based on an OpenAPI or Swagger definition. If your definition is stored in SwaggerHub, you can create an empty project, and then import the definition 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
.yamlor.jsonspecification 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
See Also
Creating Projects
Creating Project From REST URL
Creating Project From WADL Definition