API Products

What is API Product or API Product?

API Product is a product created by combining one or more APIs. These APIs can be combined and presented to end users as an interface by exchanging data from different sources or systems.

API Products facilitate the use and management of APIs, while helping developers develop their own applications or services by using different APIs together.

All API Products published in the API Developer Portal or in draft stage are managed from this screen.

The listing screen has two different views; chart and list.

The picture below shows the graphic view screen details:

The picture below shows the list view screen details:

Creating a New API Product

An API Product can be created from an API Proxy or API Proxy Group. There are three stages in this process; API Product Information, Visibility and Plan & Monetization.

API Product Information Panel

The picture below shows the API Product Information settings:

The fields used for API Product information configuration are shown in the table below.

Field	Description
Name	It is the name information that the API Product will appear on the Portal.
Image	It is the name information that the API Product will appear on the Portal.
Title	It is the description information containing the general purpose of the API Product that will appear on the Portal.
Categories	API Product may be included in a category. Thus, it can be filtered by category when searching on the Portal.
Responsible Unit	This is the field where the responsible unit that created the API Product is entered.
Access Type	There are 3 types of authentication types: Public: You can subscribe directly to the API Product without requiring approval. Authentication Needed: It can be subscribed directly without the approval of the Portal Manager, but in order to consume the API, the API must implement the authentication policy applied to the Product. Authentication and Permission Needed: The user's process of consuming the API consists of two stages; submitting the request to subscribe and Portal Manager approve/disapprove this request. The consumer whose subscriber request is approved must apply the authentication policy applied to the API Product to consume the API.
API Proxy/API Proxy Group	This is the section where API Proxy/API Proxy Group settings are made to be compatible with the API Product.
Select Environment	API Proxy/API Proxy Group's deployment list selects which environment API Consumers can send requests to.
Documents	This is the section where extra documents such as training are managed to shara the API Product with users.
Description	It is the documentation information of the API Product that will appear on the Portal and includes detailed information of the API Product.

Visibility Panel

The picture below shows the visibility settings of the API Product:

The fields used for API Product visibility configuration are shown in the table below.

Field	Description
Public	Anyone can view the API Product.
Only login accounts	Only accounts logged in to the API Portal can view the API Product.
Authorizated accounts	Only authorized accounts defined here can view the API Product.

Plan & Monetization Panel

API Product must maintain at least one plan&monetization for release. There are 4 different plans; Free, Subscription, Metered and Tiered.

Free Plan

If this plan is selected, the API Product can be consumed free of charge. Throttling and quota (quota) can be added.

The picture below shows the Free Plan options:

The fields used for the Free plan configuration are shown in the table below.

Field	Description
Enable Throttling	On a per second/minute basis, the number of requests to the API in a given time can be limited.
Enable Quota	On a per hour/day/month basis, the number of requests to the API in a given time can be limited.

Subscription Plan

If this plan is selected, a monthly or annual payment plan is created. In case of excess consumption, a new charging or stopping method may be applied.

The picture below shows the Subscription Plan options:

The fields used for subscription plan configuration are shown in the table below.

Field	Description
Enable Throttling	On a per second/minute basis, the number of requests to the API in a given time can be limited.
Enable Quota	On a per hour/day/month basis, the number of requests to the API in a given time can be limited.
Volume-based Fee	Adjustments made are applied monthly or annually.
Currency	Currency can be determined as Turkish lira, dollar, euro.
Billing Period	The billing period can be selected monthly (monthly) or annually (annually).
Continue on Exceed	If the specified payment plan is exceeded, the option to continue using is selected. If it is not active, consumption is stopped when the specified demand volume is exceeded.
Fee on Exceed	Charges are determined for uses after the payment plan is exceeded.

Metered Plan

If this plan is selected, per-request charges apply.

The picture below shows the Metered Plan options:

The fields used for metered plan configuration are shown in the table below.

Field	Description
A Call Fee	The fee for a request is entered.
Currency	Para birimi türk lirası, dolar, euro olarak belirlenebilir.
Billing Period	The billing period can be selected monthly (monthly) or annually (annually).

Tiered Plan

Bu plan seçilirse, katmanlı bir ödeme planı oluşturulur. Örneğin; ilk 1-10 arası istek başına 10 lira, 10-50 arası istek başına 5 lira, 50-100 arası istek başına 1 lira ... vs. şeklinde farklı aralıklara farklı ücretler belirlenebilir.

The picture below shows the Tiered Plan options:

The fields used for tiered plan configuration are shown in the table below.

Field	Description
Calls From	The initial value of the layer is determined.
Calls To	The final value of the layer is determined.
Fee	The fee in the specified tier range is determined.
Billing Type	If the tier pricing is to be determined on the basis of the total tier, it is Volume-based, or if a fee will be charged for each request in the tier, Transaction-based is selected.
Currency	Currency can be determined as Turkish lira, dollar, euro.
Billing Period	The billing period can be selected monthly (monthly) or annually (annually).
Continue on Exceed	If the specified payment plan is exceeded, the option to continue using is selected. If it is not active, consumption is stopped when the specified demand volume is exceeded.
Fee on Exceed	Charges are determined for uses after the payment plan is exceeded.

Publishing API Product

There are 2 states that must be provided for the API Product to be published: It must have a plan and the API Proxy must have an Authentication Policy of the Security Manager type.

If these two conditions are met, the API Product is ready for publication in the Catalogue. To publish the API Product, the Publish button is pressed and the API Product starts to appear in the catalog.

After API Product is published, it can be unpublished without deleting this definition to prevent it from appearing only in the API Catalog.

Deleting API Product

To delete the API Product completely, go to the edit page of the relevant product. At the bottom of the page, there is the title Delete API Product.

To confirm that you want to delete the API Product, a check box opens where the name of the relevant product is requested. When the product name is written correctly and the Delete button is clicked, the product is completely deleted.

The picture below shows the checkbox that appears when the API Product Delete button is clicked: