Contents

Popular

The Documentation section is used to edit the project's documentation available for clients in the Developer portal. Most of the documentation is automatically generated based on policy definitions as well as any conversions done across the proxy pipeline. User can add further information about the business side of the resources and their applicability.


Figure 1: Documentation section properties

Below are the basic attributes present under Documentation section.

AttributeDescription
Project Base PathProxy Context Path provided while creating the project.
VersionVersion number provided while creating the project.
StatusStatus (Active/Deprecated/Retired) of the project, as provided in the Summary section.
Short DescriptionProvide a short description of the project.
Long Description

Provide a detailed description of the project.

In case the details are too long, click more to expand the text field and view the entire data without scrolling.

The documentation corresponding to a particular resource can be configured by selecting the resource and configure its documentation which is classified into following sections.

  • Details
  • Parameters
  • Custom Parameters

Details

This section comprises of optional data input fields where you can record more details about the resource for display in the Developer portal.

AttributeDescription
Short DescriptionProvide a short description of the resource.
Long Description

Provide a detailed description of the resource.

In case the details are too long, click more to expand the text field and view the entire data without scrolling.

ConsumesProvide the incoming request type. This generally corresponds to the Content-Type Header of the incoming request from client.
ProducesProvide the output response type after calling the target API. This generally corresponds to Accept header of the incoming request from client.
Input DescriptionProvide details about the input to the resource.
Output DescriptionProvide details about the output from the resource
Input SampleProvide a sample of the input request. This can be very helpful for developers using the API.
Output SampleProvide a sample of the output response. This can be very helpful for developers using the API.


Figure 2: Details section under Documentation

Parameters

Different parameters that are part of invocation of this resource are automatically generated and relevant documentation is generated.

AttributeDescription
NameName of the parameter
TypeType of the parameter (Form Param / Header / Query Param)
Default ValueDefault value of this parameter
DescriptionDetails of this parameter
Is RequiredWhether the parameter is mandatory or optional


Figure 3: Parameters section under Documentation

Custom Parameters

Parameters which are not automatically generated  but might be required for the target server or any service call out can be added using this section. Add parameters by clicking Add button to add more parameters (attributes as explained under Parameters section above).

Type-in the parameters in the respective text fields and select from the below drop-downs.

Type:  Select from the options as below

  • Form Param
  • Header
  • Query Param

Is Required: select from the options true/false


Figure 4: Customer Parameters section under Documentation

Adaptavist ThemeBuilder EngineAtlassian Confluence