# API Manager

<figure><img src="/files/qLWvpynzzK1D1s6KgI79" alt=""><figcaption></figcaption></figure>

* [Add/Edit API](#add-edit-api)
* [Create as Private API](#create-as-private-api)
* [Test API](#test-api)

## Add/Edit API

To manage a new API, click on "Add New" on the API manager page. A new window will open and this is where you will define parameters and other details for your API.

{% hint style="success" %}
For a private system, APIs can be added only when it has at least one credential.
{% endhint %}

{% hint style="danger" %}
DCKAP Integrator API Manager is only intended to manage APIs. The API is expected to be available in the respective systems. Adding an API here will not create the API in the respective system.
{% endhint %}

<figure><img src="/files/2Xmv2kCboaNVHX2MAKs0" alt=""><figcaption></figcaption></figure>

Provide the values for the below fields.

1. **Name**: Provide a suitable name for your API. Example: Magento2 Update Customers, P21 Get Customer Info, etc.
2. **Status**: This is a toggle ON/OFF button that allows you to enable/disable an API
3. Provide request [method](/project-manager/systems/api-manager/api-components.md#request-methods), [URL](/project-manager/systems/api-manager/api-components.md#relative-url-endpoint), [headers](/project-manager/systems/api-manager/api-components.md#headers), [params](/project-manager/systems/api-manager/api-components.md#params) and [body](/project-manager/systems/api-manager/api-components.md#request-body) for the API
4. Provide [request and response](#for-mapping-request-and-response) to use in the mapping. [Learn more.](/developers/api-and-mapping.md)
5. Provide [other details](#other-details) section (Optional)
6. API can be tested from here if needed. Navigate to [Test API](/project-manager/systems/api-manager/test-api.md)
7. Click `Save API` button to save this API.&#x20;

{% hint style="success" %}
Use the `Save All API` button to save multiple added/modified APIs at once
{% endhint %}

{% hint style="info" %}
For protocols like FTP and SFTP, APIs cannot be added. Instead, it will be used with the help of flow handlers like [FTP Reader](/developers/flows.md#ftp-reader), [FTP Writer](/developers/flows.md#ftp-writer), [SFTP Reader](/developers/flows.md#sftp-reader) & [SFTP Writer](/developers/flows.md#sftp-writer).&#x20;
{% endhint %}

### For Mapping: Request and Response

The Request and Response sections contain sample JSON data. The keys given in this JSON sample are displayed as fields in the Mapping area Source and Destination sections to enable mapping.

<figure><img src="/files/sywY5SN28zHQIMLXts8a" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
The sample request and response fields are optional (but ***recommended***) in the API Manager. If no data is entered here, then the Source and Destination fields will be empty on the Mapping configuration page.
{% endhint %}

### Other Details

#### **Skip Authentication**

Ability to skip the parent system authentication. Applicable only to systems using the following protocols - OAuth1, OAuth2, NTLM, Amazon-LWA.

#### **Override Timeout**

This is a toggle ON/OFF button that lets you choose between custom/default "maximum allowed time" values, before which a Timeout error is thrown. *Users can enter only 4-digit numeric values in the Connect and Read fields.*&#x20;

* **Override Timeout ON**: Once the Override Timeout is set to ON, two fields- Connect and Read- are displayed. You may set a time (in seconds)   in both these fields.
  * "Connect" refers to the maximum allowed time for DCKAP Integrator to establish communication with the system to which the API call is made.&#x20;
  * "Read" refers to the maximum allowed time for the system to respond back to DCKAP Integrator.
* **Override Timeout OFF:** Setting the Override Timeout to OFF, will consider default values for "Connect" and "Read".
* The default value for Read = 240 seconds. The default value for Connect = 30 seconds

#### **Description**

Provide the description/notes for the API

## Create as Private API

This is applicable to Public APIs only. Using this option, any public API can be duplicated and created as a private API to make necessary modifications.

<figure><img src="/files/WWCkYQCaSLRLaZcLlLoI" alt=""><figcaption></figcaption></figure>

## Test API

Navigate below to learn about API testing from Integrator

{% content-ref url="/pages/8M8oSck8mUbBIuvMsIxB" %}
[Test API](/project-manager/systems/api-manager/test-api.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dckapintegrator.com/project-manager/systems/api-manager.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.