Applies to ReadyAPI 2.8, last modified on September 11, 2019

To create REST projects in ReadyAPI based on an OpenAPI or Swagger definition, follow these steps:

  1. Select File > New Project.

    New Project Button

    – or –

    On the Dashboard, click New Project on the New Test tile:

    Create New Project From the Tile

    Click the image to enlarge it.

  2. In the New Project dialog, switch to the API Definition tab.

  3. 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 Browse and select a local definition file.

    Create OpenAPI/Swagger Project

    Click the image to enlarge it.

  4. 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:

  1. Add the following option to the vmoptions file:

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

Now you can import your OpenAPI specification.

See Also

Creating Projects
Creating Project From REST URL
Creating Project From WADL Definition

Highlight search results