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 3 Next »

To add API Documentation for RESTful web services:

  1. On the Develop tab, click Services > Web Service > Provider (API).
  2. Click Action  to the Restful web service.
  3. Click Add Documentation.



  4. The Add API Documentation window appears 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 DetailsDescription
    NameName of the API Documentation. By default, it shows the provider's value as the name.
    DescriptionDescription about the API Documentation.
    Contact 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 DetailsDescription
    SummaryPurpose of the method.
    NotesDescription about the method.
    API ParametersDefine API parameters by clicking Add Row.
    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 and API Documentation

After you have created RESTful Web Service for the Provider Activity, you can also view the Endpoint URL and API documentation. To view Endpoint URL and API Doc:

  1. Go to Develop > Services > Web Service > Provider (API) .
  2. Click Endpoint in the WSDL/Documentation column corresponding to the web service to view the Endpoint URL.
  3. Endpoint URL will appear in a new tab of your browser.



  4. Click Close Window to exit.
  5. Click API Doc to view the API documentation. 

    API document will open in a new window.

    Changing Logo/Image in API Documentation

    Property "abpm.webservice.rest.apidoc.imagepath" has been added to the server configure properties for which default url is "images/api_doc_header.png". To change the logo, change the image name from url. The dimension of the image should be between 50x50 and 50x650. Supported image types are PNG, GPG, GIF, and BMP."

  6. Click API method to view API documentation details.



  7. Click Try it out to view the response. 

    You can also view the API documentation of all web service providers populated on one screen by clicking API Doc from the Web Service Provider manage screen.

     



  • No labels