Page Comparison

To add API Documentation for RESTful web services:

1. Click Configure > WEB SERVICES > REST Provider.
2. On the REST Provider screen, click to the Restful web service.

3. Click Edit Documentation.

4. The In the Edit Documentation window appears with API Documentation window, enter the values for the fields in the sections, API Documentation and Method Details for the chosen RESTful web service. By default, the values in the API Details section are filled automatically based on the chosen web service. , as described in the tables next to the screenshot.

   
   

   Tip
   You can change the pre-populated values as per your requirements.

   
   

   Image RemovedImage Added

   Name of the API . By default, it shows the provider's value as the name.

   API Details	Description
   Name
   Documentation
   	Description
   Description about the API Documentation.
   Email	Valid email address to send queries.
   Title	Title of your API documentation. It must contain alphanumeric and few special characters (_ - . : , @ $ ? \\ and space) and must start with an Alphabet/Underscore/Number).
   Description	A short description of the API Documentation.
   Email	Valid email address to send queries.
   License Name	The name of the license for the API endpoint.
   License URL	The URL of the license for the API endpoint.
   Version	A version for the API. It lets the user know exactly what sort of differences exist between the newest version and the version they are using.
   Name	Name of the API Documentation. By default, it shows the provider's value as the name.
   Server Description	The name of the environment that will be displayed adjacent to the server URL in the API documentation. For example: Sandbox, Production, Testing etc.

   
   

   Method Details	Description
   Summary	Purpose of the method.
   Notes	Description of the method.
   API Parameters	List of parameters, if provided at the time of creating Web Service Provider activity.
   Method Presentation	Status code of the request, response, and fault. You can also provide the description of the status code.

   
   

5. Click Save.
   

...

1. Click Configure > WEB SERVICES > REST Provider.
2. Click Endpoint in the Documentation column corresponding to the web service activity.
   Image Removed
   Image Added
   
   This displays the Endpoint URL in the new tab of your browser.
   Image Removed
      
   Image Added       

Viewing API Documentation

...

1. Click Configure > WEB SERVICES > REST Provider.

2. Click API Doc in the Documentation column corresponding to the web service activity.
   Image Removed
   Image Added
   
   

3. This displays the API documentation (OAS3 standards) of the selected activity in the new tab of your browser.
   Image Removed
   Image Added
   
   

4. Click API Doc to view the API documentation of all web service activities.
   Image Removed
   Image Added
   
   

   Option Name	Description
   Show/Hide	Show or hides all APIs.
   List Operations	Displays the list view of all the expanded APIs.
   Expand Operations	Expands all APIs to view details.

   The list of all web service activities populates on the screen, in case you are viewing API documentation of all web service activities. Select the activity from the left menu to view API details of that activity.

5. Click API method or the expansion element  to view the API details. 
   Image Removed
   Image Added
   
   

6. Provide the details in the fields, and click Try it out to view the response.

...