Integrations

The Integrations section is where users will configure and set up pipes. Every pipe contains a name and system credentials, is linked with a Flow, and may or may not have a Mapping configuration.

What is a Pipe?

A Pipe is a single integration unit, i.e., the sub-unit of every system integration, responsible for synchronizing all entities (Customers, Orders, Products, etc.). Each pipe is mapped to a Flow to carry out the underlying integration logic.

For a quick video explainer of What are Pipes?, click here.

Pipe Types

Data synchronization will be handled periodically at certain configured time intervals. This is the most commonly used Pipe type since it offers optimum performance.

Example: Every 2 hours

Data synchronization is done in real-time using an API call from any system through DCKAP Integrator. For example, services like Pricing may be configured as a Dynamic Pipe to fetch the prices in real-time.

Use the following URL to run all your dynamic services in integrator.dckap.com:

https://lightning.dckap.com/v1/dynamic/listener/{pipe_id}

This URL can also be got by clicking on the COPY URL button in the Integrations page.

During a dynamic call to V3 or lightning, 400 and 401 Status codes will be returned for a disabled pipe and invalid credentials respectively.

For all other errors, 200 Status code will be returned.

During dynamic calls, it is possible to authorize DCKAP Integrator by using access_token, jwt_token in headers/params.

Examples:

http://0.0.0.0:2020/v1/dynamic/listener/<id>?access_token=<token>

http://0.0.0.0:2020/v1/dynamic/listener/<id>?token=<jwt_token>

Manage Pipes

The pipes are displayed either as a Grid or a table.

In the Integrations page, the following information is present in grid/tabular form:

Field Name

Sample

Description

Status

Enables or disables the working of a pipe, used especially during scheduled synchronization

Pipe Name

Displays the name of Integration Pipe

Systems

Systems connected in the pipe

Type of Integration

  • Batch: When the data synchronization is done periodically

  • Dynamic: When the data synchronization is done in real-time using an API call to the system

Sync status

Displays the time at which the last sync was performed and if the sync was complete or not

Sync Now &

Copy URL button

For Batch type Integration ⇒ Start the integration process by manually clicking on the Sync Now button.

For Dynamic type Integration ⇒ Copy URL and share across different systems to access data from the system

View Logs

To view Logs of this pipe

Enable/Disable Autopilot Mode

Only for Batch type Integration. To enable or disable Autopilot mode.

For Dynamic pipe, scheduling is disabled.

Enable/Disable Console Logs

To enable or disable console logs for this Integration

Auto Pilot Mode and Scheduler

For a Dynamic pipe, the ability to schedule is disabled

Last updated