DCKAP Integrator
Getting StartedIntegrator StatusRoadmapRelease Notes
  • Overview
    • Enterprise Integration Platform
    • What is DCKAP Integrator?
    • Integrator Architecture
    • Integrator Security
  • GETTING STARTED
    • Quick Start Guide
    • New User Registration
      • Available Plans
    • Integrator Dashboard
    • Analytics
  • User Guide
    • The Basics
    • Account Management
      • User Groups
      • Account Settings
      • Two-Factor Authentication
    • Projects
      • Add New Project
      • Managing Projects
      • Transfer Project Ownership
    • API Access Keys
    • Project Invitations
    • Help and Support
      • Raise a Ticket
      • Visibility and Collaborators
      • Help and Support - A Quick Overview
    • Exchange
  • PROJECT MANAGER
    • Integrations
      • Add New Pipe
      • Flows and Handlers
      • Mapping and Modifiers
      • Advanced Modifiers
      • Advanced Scheduler
    • Workflows
      • Flow Builder
      • Snippets
      • Actions
        • API Call
        • Console
        • Decision
        • Loop
        • Detail Logger
        • Error Logger
        • Code Runner
        • Formatter
        • Notification
        • Snippet
        • Return
        • Sleep
      • Mock Data
      • FAQs
    • Systems
      • Credentials
      • API Manager
        • API Components
        • Test API
      • Private Systems
      • Authentication Types
        • OAuth 2.0
    • Logs
    • Project Settings
    • Project Analytics
    • Advanced
      • Flows
    • Project Documents
  • TECHNICAL GUIDE
    • Flows & Handlers
      • Add New Flow
      • Simulator
      • Flows: Best Practices
      • Flows: Use Cases
      • Timezone Converter Handler
      • Supported Timezones
    • API and Mapping
  • Tutorials
    • Create a new Integration Pipe
    • Create a new Flow
    • How to Map data?
    • Working with Modifiers
    • Managing User Groups
    • How to use DCKAP Integrator Dynamic URL's?
  • API Documentation
    • Quick Start
    • Projects API
    • Credentials API
    • Templates API
    • Posting and Reading XML data via DCKAP Integrator
    • Commonly used APIs
  • Others
    • Product Roadmap
    • Release Notes
      • 4.4.0 April 29, 2025
      • 4.3.0 February 25, 2025
      • 4.2.0 December 19, 2024
      • 4.0.0 August 29, 2024
      • 3.4.8 May 27, 2024
      • 3.4.7 March 14, 2024
      • 3.4.6 January 4, 2024
      • 3.4.5 October 18, 2023
      • 3.4.4 May 16, 2023
      • 3.4.3 March 1, 2023
      • 3.4.2 December 20, 2022
      • 3.4.1 October 4, 2022
      • 3.4.0 August 10, 2022
      • 3.3.6 July 20, 2022
      • 3.3.5a June 23, 2022
      • 3.3.5 May 26, 2022
      • 3.3.4 March 31, 2022
      • 3.3.3 Feb 4, 2022
      • 3.3.2 November 24, 2021
      • 3.3.1 October 22, 2021
      • 3.3.0 August 28, 2021
      • 3.2.7 June 18, 2021
      • 3.2.6 May 11, 2021
      • 3.2.3 and 3.2.4 March 8, 2021
      • 3.2.2 Dec 24, 2020
      • 3.2.1 Nov 12, 2020
      • 3.2.0 - October 7, 2020
      • 3.1.10 - September 16, 2020
      • 3.1.9 - September 3, 2020
      • 3.1.8 - August 15, 2020
      • 3.1.7 - July 19, 2020
      • 3.1.6 - June 21, 2020
      • 3.1.5 - May 15, 2020
      • 3.1.4 - April 27, 2020
      • 3.1.3.0 - April 20, 2020
      • 3.1.3 - April 8, 2020
      • 3.1.2 - March 26, 2020
      • 3.1.1 - March 13, 2020
      • 3.1.0 - March 10, 2020
Powered by GitBook
On this page
  • Options
  • Choose System
  • Choose API
  • Choose Credential
  • API Information

Was this helpful?

  1. PROJECT MANAGER
  2. Workflows
  3. Actions

API Call

PreviousActionsNextConsole

Last updated 10 days ago

Was this helpful?

Triggers an API Call in which you can pass parameters and payload to any system. The API responses will be returned as step output which is available under the data hub for further usage in the workflow.

Options

Choose System

Search and select the target system from the list of private and public systems available under the current project as shown in the below image.

Choose API

Choose Credential

After selecting the target API, you have to choose or add the credentials to connect to the target system.

Here you can also test the credentials before selecting it, using the option Test with Fresh token.

API Call action is allowed to save only after selecting the System, Api and Credentials

API Information

Payload

API Request Body. This section allows the user to provide payload and also the ability to modify using Mapping & Modifiers and Preprocessor. The final payload will be sent while making the API request.

  • Payload - Request Body. Information is sent along with the API call. You can provide data directly to the payload or select the data of previous steps from the data hub.

  • Total Records - Number of records received/created using the API call. You can provide an integer value directly or select the length of data from previous steps using the data hub.

    • Mapping & Modifiers - Provides the ability to get mappings from the user and format data before calling destination API.

      • Data from the source fields are mapped to the associated destination fields and then formatted using Modifiers.

      • Payload is considered as Source Data.

Preprocessor

Provides the ability to modify the payload before making an api call. Use the code editor to modify the data.

Use the preprocessor when you need to:

  • Modify or set payload data

  • Modify or set a parameter value based on a condition

  • Modify or set a header value based on a condition

This avoids duplicating steps or adding complex logic to earlier workflow stages. Preprocessor runs before the request is sent, allowing you to update keys and values conditionally.

Payload - Order of Execution

Payload ➡️ Mapping & Modifiers ➡️ Preprocessor

The initial payload will be modified in Mapping & Modifiers. The mapped payload will be modified in Preprocessor. If mapping is not configured, the initial payload will be modified in the Preprocessor.

The order cannot be changed. If payload modification is not needed, Mapping & Modifiers and Preprocessor can be skipped.

Response Validation

Users can set conditions to validate the API response. If the condition is met, it follows the successful workflow path; if not, it takes the failure path. Conditions can include checking if the API is successful using the status code or ensuring it contains data, among other business-specific criteria.

By default, each API call includes a condition to check if it's successful using the status code, but users can modify this condition using the condition builder to better suit their needs. This ensures flexibility and adaptability in response validation.

For some systems, the successful API response status code is not just 200. It may return 201 too. In such cases, you can modify the condition builder to use the "in" condition from the dropdown and provide values as a list. Example: [200, 201]

Advanced Options

The following are the other additional parameters which you can provide to make an API call.

  • Headers - Request Headers. Example: {"Accept": "application/json"}

  • Files - Upload one or many file contents. Example: [('file', ('foo.csv', "hello,there,csv,data")), ('file',('bar.txt', "this is a file content"))]

  • URL Arguments - Arguments used in a dynamic URL.

    • Example Use Case:

      API URL: /api/customer/{customer_id}/fetch

      URL Argument: {"customer_id":"2"}

      Formatted URL: /api/customer/2/fetch

      In this case, customer_id is replaced with the number 2.

  • Parameters - Request parameters

    • Example Use Case:

      API URL: api/customer/get/?format={format}

      Query Params: {"format":"json"}

      Formatted URL: api/customer/get/?format=json

      Here, format = json will be the query parameters.

  • Override Timeout - To override the timeout at the flow level.

    • To override the API manager timeout at the Flow level.

      • Choose - Yes/No from the drop-down list. Yes - Override the timeout based on the read and connect values mentioned here. No - Do not override the timeout based on read and connect values mentioned here

      • "Connect" refers to the maximum allowed time for a 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 the DCKAP Integrator.

For XML Payload (Examples)

Plain request

{'plain_request': {'key1':'value1','key2':'value2'}}

Not a plain request

{'body':{'key1':'value1','key2':'value2'}}

Use keywords(DYNAMIC_TOKEN, GET_FROM_CREDENTIALS) to fetch and pass the respective dynamic information in headers and payload.

  • DCKAP Integrator accepts API responses in JSON, CSV and Text formats.

  • API Call action also has the facility to add headers from Flows.

To add additional envelope namespace

Along with the above request, add another key “envelope_namespace” to add additional namespace with default namespace

XML Request Body

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:enterprise.soap.sforce.com">
   <soapenv:Header>
   </soapenv:Header>
   <soapenv:Body>
      <urn:login>
         <urn:username>user1@ddckap.com</urn:username>
         <urn:password>user1@123</urn:password>
      </urn:login>
   </soapenv:Body>
</soapenv:Envelope>

Converted JSON request Body

{
    "envelope_namespace": "xmlns:urn='urn:enterprise.soap.sforce.com'",
    "body": {
        "urn:login": {
            "urn:username": "user1@ddckap.com", 
            "urn:password": "user1@123"
        }
    }
}

After selecting the target system, the list of available active APIs of the selected system will be seen as shown in the below image. This can be managed in the .

For more details on how to create a mapping, navigate to

API Manager
Mapping and Modifiers
Choose System
Choose API
Choose Credentials
Provide API Information