Contents

Popular
 Contents

This option allows to add a proxy project to an existing backend REST or HTTP services which can be used for the request types: REST or HTTP respectively.

Adding the Project

To add a REST/HTTP Service project, click the  Add API Project button and click the From REST/HTTP Service option.


Figure 1: Navigating to create project from REST/HTTP Service

Providing Basic Attributes

Enter values for attributes in the New Backend Service dialog box as described in the table below.


Figure 2: New Backend Service dialog box to provide details of REST/HTTP Service

PropertyDescription
Display NameA name to act as Project ID to identify the project.
VersionRevision number of the project, for example, 1.0 for a project being newly added and 1.1 or 2.0 for the next revision.
Backend Service URLURL of the service provider from where data is to be fetched after implementing the policies that are defined.
Method

HTTP method used by the back end Service to send requests by using the following methods:

  • GET: Requests data from a specified resource
  • POST: Submits data to be processed to a specified resource
  • PUT: Uploads a representation of the specified URI
  • DELETE: Deletes the specified resource
  • PROXY: The same method that the client uses to invoke the proxy server will be used to invoke the target server.


Figure 3: Options of HTTP Method

Proxy Context Path

A text used to combine with the version number to act as an identifier to map with a particular deployed project. The proxy resolves context path mappings prior to applying any matching policies (explained in subsequent topics).

Icon
  • Proxy Context Path combined with version number must be unique for every project.
  • Different versions of the same project (same project name with different version number) can have the same Context Path.
MethodHTTP method used by the app to send requests to proxy by using the methods GET/POST/PUT/DELETE as explained previously. 

After enetering the above details, you may click Finish to create the project, or click Next to:

  • Add Security policy or to add Quota policy.
  • Attach an existing product to this new project. 

API Customization - Enabling Security and Quota

Generally, policies are created for a project after adding the project, but Security policy and Quota policy can be created while creating a project itself. To do this, click Next  from the basic properties screen and select the attributes accordingly.


Figure 4: Options to provide security attributes and enforce Quota

PropertyDescription
Secure API with

Enables security to the requests with the following security options:

  • None: No authentication checks will be done.
  • API Keys: Checks for the authentication key which gets generated for API Product (as explained in the last portion of "Adding Products, Clients and Client Subscriptions section" in the Quick Start page.
  • OAuth 2.0 Access Tokens: Protocol used for for authentication and authorization.
Enforce QuotaWhether or not to enable the default Quota policy.

After entering the above details, you may click:

  • Finish to create the project
  • Next to attach a product to this new project.
Icon

If you need to amend the basic details that you had entered, click Previous button to move back to the first screen.

Product Mapping - Attaching a Product to the Project

The existing projects get reflected in the Attach to API Policy drop-down list; select the respective product to attach it to the project.


Figure 4: Option to attach existing product(s) to the project

 

Icon

If you need to amend the Security/Quota details that you had entered, click Previous button to move back to that screen.

Adaptavist ThemeBuilder EngineAtlassian Confluence