The DCKAP Integrator API Manager provides a user-friendly template to add, edit, manage and store any number of system APIs. The APIs that are added here are later used in Flows and Mapping.
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.
For a custom system, APIs can be added only when it has at least one credential.
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.
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
Save APIbutton to save this API.
Save All APIbutton to save multiple added/modified APIs at once
For protocols like FTP and SFTP, APIs cannot be added. Instead, it will be used with the help of flow handlers like FTP Reader, FTP Writer, SFTP Reader & SFTP Writer.
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.
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.
Ability to skip the parent system authentication. Applicable only to systems using the following protocols - OAuth1, OAuth2, NTLM, Amazon-LWA.
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.
- 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.
- "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
Provide the description/notes for the API
This is applicable to Global APIs only. Using this option, any global API can be duplicated and created as a custom API to make necessary modifications.
Navigate below to learn about API testing from Integrator