Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

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. In the Edit Documentation window, enter the values for the fields in the sections, API Documentation and Method Details, as described in the tables next to the screenshot.


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


    API Documentation

    Description

    TitleTitle of your API documentation. It must contain alphanumeric and few special characters (_ - . : , @ $ ? \\ and space) and must start with an Alphabet/Underscore/Number).
    DescriptionA short description of the API Documentation.
    EmailValid email address to send queries.
    License NameThe name of the license for the API endpoint.
    License URL The URL of the license for the API endpoint.
    VersionA 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 of the API Documentation. By default, it shows the provider's value as the name.
    Server DescriptionThe 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

    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.

...