From Swagger
Files describing the RESTful API in accordance with the Swagger specification are represented as JSON objects and conform to the JSON standards. YAML, being a superset of JSON, can be used as well to represent a Swagger specification file.
Swagger projects are used to create APIs from a Swagger file.
For more information about the Swagger file format, refer to the link: https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md
Adding the Project

Figure 1: Navigating to create a project using RIM file
Providing Basic Attributes
Provide values for the properties in the New API Project dialog box.

Figure 2: Swagger Project properties
Property | Description |
---|---|
Display Name | A name to act as Project ID to identify the Swagger project. |
Version | Revision number of the project. For example, 1.0 for a project being newly added and 1.1 or 2.0 for the next revision. |
Proxy Context Path | This is a text used to combine with the version number to act as an identifier to map a particular deployed project. The proxy resolves context path mappings prior to applying any matching policies (explained in subsequent topics).
|
Target Base Path | Target server URL where the application needs to use the service. |
Load .json/.yaml | Click Choose File button to browse and choose the Swagger file with .json or .yaml extension. |
After clicking the Next button, it is possible to perform API Customization and Product Mapping in the subsequent screens. Refer to the sections in the From REST or HTTP Service section.