Follow the instructions given below to generate a REST API using a Swagger definition. Alternatively, you can create a REST API using WSO2 Integration Studio.
Note |
---|
Note that this feature is currently available through the management console of the ESB profile. |
Table of Contents
Prerequisites
The To use the Swagger UI requires you need to have configure CORS configured in order to function properly. The following steps should be followed to correctly configure CORS. Open the in the ESB server.
Open the synapse.properties
file (stored in the <EI_HOME>/conf/
directory) and add the following configuration. Note that the synapse
.properties file and add the following configuration.rest.CORSConfig.Access-Control-Allow-Origin
property points to https://localhost:9443 as the value, and thereby enables CORS for localhost. You can add all the required URLs as a comma-separated list.
Code Block |
---|
synapse.rest.CORSConfig.enabled=true synapse.rest.CORSConfig.Access-Control-Allow-Origin=https://localhost:9443,http://localhost:8280 synapse.rest.CORSConfig.Access-Control-Allow-Headers=content-type |
Notice the synapse.rest.CORSConfig.Access-Control-Allow-Origin property has a value of https://localhost:9443 and this will enable CORS for localhost. You can define as many URLs as desired as comma-separated values so that CORS will be enabled for all defined URLs.
Step 1: Generating the API
Follow the steps given below to generate the API using Swagger.
- Start the ESB profile of WSO2 EI.
- Open the management console of the WSO2 Enterprise Integrator and click on APIs in the Main tab. Click on Generate API as depicted in the image WSO2 EI, go to the Main tab, and click API to open the Deployed APIs screen.
- Click Generate API as shown below.
- The Swagger UI will then open. On the left side, the The Swagger definition of a sample API is shown and on the right side, left and the details of the API is shown on the right. You can edit the this Swagger definition as desired or . Alternatively, you can import your own Swagger definitions by importing via definition using a URL or by uploading a definition file through the File menu of the Swagger editor.
- Once done, click on the Click Generate API button to generate the API as depicted below.
The synapse configuration of the generated API will then be shown. - Clicking Save will save the API and redirect . You are now redirected to the Deployed APIs section.
- The following options are available for the API:
- 1 - The swagger button will direct Swagger option directs to the swagger Swagger definition of the API.
- 2 - The Try This API button will direct option directs to the TryIt tool, which allows testing you to test the API.
Step 2: Editing the API (Optional)
Once you have generated the API using Swagger, you have the option of editing the API as follows:
- Click the Edit button and it will to open the Edit API view. Click on the Edit swagger button to , and then click Edit Swagger to view the Swagger editor.
On the left side, the editable swagger definition is shown and on the right side, API details along with the Try it out options are shown. More details about the Try it out tool is explained in the next sections of this guide. Once done with the editing, click on the Apply Changes button and it will redirect Once you finish editing, click Apply Changes and you will be redirected to the Edit API view. Click Save
Save the changes in the Edit API view and the API . You will be saved and you will be redirected now be directed back to the Deployed APIs view.
Step 3: Trying out the API
Let's test the API by executing a sample request:
In the Deployed APIs view,
click on theclick Try This API
to try outfor the API
with sample requests and responses. Clicking this will open the. The Try it out tool opens in a new browser tab.
loggingTip Note that this UI is accessible even without
thesigning in to
WSO2 EI.
- In the Try Try it out view, defined services of the API are shown and once . When you click on a service, it will expand and show the evaluate view of the selected service.
- Click on the Click Try it outbutton and it will show and you will get the following view.:
- You can edit the payload and also set the content type of the request and the response. Click on Execute to send the request.
The response will be shown along with several other details such as the cURL command used, request URL, response code and , etc.