Contents

Popular
Contents

Overview section, which contains the basic information of a project, is the main in the API Projects screen. Expand the Overview section under the Project Details heading to display details of the project.


Figure 1: API Project Summary section

Overview

The Overview section displays a project's basic information available for clients in the Developer portal. Most of the documentation is automatically generated based on policy definitions as well as any conversions across the proxy pipeline.

If the project is deployed, it would be displayed along with the project name on top of the screen (see the figure above).

This section displays the summary of the project represented by the properties as described below.

PropertyDescription
Proxy Context Path

The Project Context Path provided while creating the project.

Icon
  • Different versions can have the same Proxy Base Path name.
  • Proxy Base Path name can be changed to a different one by editing the text field.
Short DescriptionProvide a short description of the project.
VersionThe version number of the project provided while creating the project.
Long Description

Provide a detailed description of the project.

If the description exceeds the text field, click more to expand the text field and view the entire data without scrolling.

Status

Present status of the project.

Status can be changed by choosing the options in the drop-down list as below:

  • Active - A normal API Project that can be launched and used in API products for clients.
  • Deprecated - API Projects can be deprecated to restrict them from being added to new API Products for clients when a better alternative is available. A Deprecated API project continues to work in existing API Products but cannot be added to new Products.
  • Retired -  A Retired API Project indicates that the project is obsolete and cannot be used. Projects cannot be launched if they are marked Retired.
Tags

Provide a keyword for the project. This tag can be used to find this particular project while filtering projects.

Date CreatedDate and time of the creation of the project.
Last ModifiedDate and time of last modification of the project.
Documents

Any documentation related to the project. Click the Add Document button to add a document and click Upload to save it to the Project.

Use the Download icon to download the document and Delete icon to remove it from the project.

Icon

After editing, ensure clicking the Save icon to apply changes made to the project.

Icon

While editing values of properties Proxy Base Path or Status (prior to saving it), Reset  icon may be used to revert to default values.

Resource

Users can add further information about the business applications of the resources and their applicability.

Expand the resource to see the details of the resource added to the project. 

Icon

Default Resource will be present in a project even if no resource is added manually.

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

URIs

Server Group, Type and URL.


Figure 2: URIs section under Project Details

Details

This section comprises optional data input fields where more details about the resource can be added to be displayed in the Developer portal.


Figure 3: Details section under Project Details

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

Provide a detailed description of the resource.

If the description exceeds the text field, 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 the client.
ProducesProvide the output response type after calling the target API. This generally corresponds to Accept header of the incoming request from the 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.

Parameters

Click the Add icon to add Parameters which may be required for the target server or any service call out as part of the invocation of the resource.

Type-in the parameters in the respective text fields or select from the drop-downs for Type and Required option. Below are the descriptions of parameters.

AttributeDescription
NameName of the parameter.
Type

Type of the parameter:

  • Header
  • Query Param
  • Path Param
  • Form Param
  • URL Encoded
Default ValueThe default value of this parameter.
DescriptionDetails of the parameter.
Requiredtrue/false.


Figure 3: Parameters section under Documentation

Response Details

Response of requests appear here.

Adaptavist ThemeBuilder EngineAtlassian Confluence