Connect to Destination
This block enables you to define the details of the v2 API that will be used for running the dataflow. The API details are auto-filled. You must enter the API client key and secret key to initiate the API.
The table contains the fields and their descriptions.
| Field name | Description |
|---|---|
| Client Key | Enter the API client key. For information on creating an API client key, refer to Creating API client key and secret. |
| Client Secret | Enter the API client secret. For information on creating an API client key, refer to Creating API client key and secret. |
| API EndPoint | API endpoint. For example, /v2/customers. This field is auto-filled for the available templates. |
| API Base Url | API cluster URL of the org. For more information on cluster URLs, refer to documentation on host URLs. This field is auto-filled. |
| OAuth Base Url | This URL is used when an API uses the OAuth for authentication and authorization, serving as the base address for the authorization server. For example: {host}/v3/oauth/token/generate. This field is auto-filled for the pre-defined templates. |
| API Method | API method. For example, POST. This field is auto-filled for the pre-defined templates. |
| Bulk Support | If set to true, allows for processing multiple records within a single JSON payload. Setting a grouping limit greater than one indicates that the system can create bulk payloads for downstream API calls. This field is auto-filled for the pre-defined templates. |
| Request Split Path | Use the default value. |
| Response Split Path | Use the default value. |
| Recoverable Error Codes | Specific error codes that indicate situations in which the system should attempt to retry the failed operation. For example, you can error codes such as - 502 Bad Gateway, 504 Gateway Timeout, 520 Unknown Error, 521 Web Server Is Down etc. |
| Parse Path Map | Lets you define expressions to parse the status message and error code from your API response, and include them in the error file. This is crucial since API responses can have varying structures for error information. This field is auto-filled for the pre-defined templates. Ex: {"status_code": "$.error.code", "error_message": "$.error.message","displayLabel": "$.error.displayLabel"} |
| Yielding Error Codes | Error codes that will be retried an unlimited number of times. This strategy is usually reserved for specific error types where the expectation is that the issue will eventually resolve without intervention, but it might take an indefinite amount of time. Example: When a "429" error (indicating that the request rate is too high) is encountered, the system configured with this strategy will retry the request indefinitely until it is successful. This is because the rate limit is expected to eventually lift, allowing the request to proceed. |
| Max Retries | Defines the maximum number of attempts to make an API request in case of failures. This field is auto-filled for the pre-defined templates. |
| Additional headers | Applicable only for certain templates. This enables the auto-approval for the request. For example, for issuing goodwill points or for tagging customers to an old transaction templates, this enables auto-approval for those requests. |
Error Handling
In case of any errors connecting to the destination URL, refer Troubleshooting guide.
Updated 1 day ago