Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

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 Edit Documentation window appears with API 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. You can change the values as per your requirements.

    API Details

    Description

    NameName of the API Documentation. By default, it shows the provider's value as the name.
    DescriptionDescription about the API Documentation.
    EmailValid email address to send queries.
    TitleTitle of your API documentation. It must contain alphanumeric and few special characters (_ - . : , @ $ ? \\ and space) and must start with an Alphabet/Underscore/Number)

    Method Details

    Description

    SummaryPurpose of the method.
    NotesDescription of the method.
    API ParametersList of parameters, if provided at the time of creating Web Service Provider activity.
    Method PresentationStatus code of the request, response, and fault. You can also provide the description of the status code.
  5. Click Save.

Viewing Endpoint URL

To view Endpoint URL of a web service activity:

  1. Click Configure > WEB SERVICES > REST Provider.
  2. Click Endpoint in the Documentation column corresponding to the web service activity.



    This displays the Endpoint URL in the new tab of your browser.


               

Viewing API Documentation

To view API documentation of a web service activity:

  1. Click Configure > WEB SERVICES > REST Provider.
  2. Click API Doc in the Documentation column corresponding to the web service activity.



  3. This displays the API documentation of the selected activity in the new tab of your browser.



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



    Option Name

    Description

    Show/HideShow or hides all APIs.
    List OperationsDisplays the list view of all the expanded APIs.
    Expand OperationsExpands 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 a particular activity.

  5. Click API method or Expand Operations to view API details. 



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




  • No labels