The External API Integrator tool contains an Endpoints tab which stores API endpoints, methods and an authentication token (either added in Request Header via Custom Parameters or via Request Body). Once the tool is configured, configure an External API Integrator pipeline step that will integrate with their tools to make a RESTful API call.
...
6. Provide EndPoint Field Configuration values:
Request Header - Use Authorization Bearer Token
...
Token Type - Choose a Long Lived Bearer Token or Short Lived Bearer Token.
Authorization Token Custom Parameter - If you are required to include a header token, it must first be added to Custom Parameters (saved in Tool Registry) in order to be selected from this drop-down. Authorization Tokens must be encrypted Custom Parameters. Do not include "Bearer" in the Custom Parameter. This field is not required if you have an API token. You can add the API token to Request Body.
...
External API Integrator Tool - Select a configured External API Integrator Tool from the drop-down. This is fetched from the Tool Registry.
...
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Note: Successful Completion Evaluation Rules take precedence over In Progress Evaluation Rules. If the response does NOT match either the Successful Completion OR In Progress Evaluation Rule, it will be considered a failure. The Pipeline will continue running while it meets the In Progress Evaluation Rules until it meets the criteria for Successful Completion or until the Pipeline Run timeout is reached. |
Connection Check
...
API Configuration - To verify the connection, enable the ‘Use Validate Connection Check’ toggle. Select the Connection Check Validation Endpoint configured in the External API Integrator Tool in the Endpoints tab.
Successful Connection Validation Evaluation Rules - Set evaluation rules for Connection Check.
Evaluation Option - Select Response Field Evaluation or Status Code from the drop-down.
Status Code - Evaluate connection based on the status code.
Filter - Select ‘Is Equal To’ or ‘Is Not Equal To’ from the drop-down.
Value - Provide a value to evaluate. Value can be equal to a specific value or ‘object', ‘array’, ‘boolean’ or ‘string’.
Response Field Evaluation - Evaluate connection based on the response of evaluation rules. This field will meet the requirements if:
Filter - Choose a selection from the options in the drop-down:
‘This Rule will be successful if any of the field evaluation rules listed below are met’
‘This Rule will be successful if all of the field evaluation rules listed below are met’
‘This Rule will be successful if none of the field evaluation rules listed below are met’
Field Evaluation Rules - Select Field Name (provided during Tool setup in Response Body). Evaluate if the connection will be successful based on if the Field Name meets the following requirements:
‘Equals’
‘Does Not Equal’
‘Is Not Null’
‘Is Null’
Value - If ‘Equals’ or ‘Not Equals’, provide a value to evaluate based on the provided Field Name. Evaluate if the connection will be successful in relation to the Field Evaluation Rules.
Run Trigger
The Run Trigger rules evaluate the API call as it is in progress.
API Configuration:
...
Validation Evaluation Rules.
Call Operation
API Configuration - Select the Call Operation Endpoint and Query Parameters to evaluate.
Successful Trigger Evaluation Rules - Set evaluation rules for the Call Operation.
Status Check
The Status Check rules evaluate the API call upon completion.
API Configuration - Select the Status Check Endpoint and Request Body to evaluate.
In Progress Evaluation Rules - Set evaluation rules for the Status Check In Progress Evaluation Rulestate.
...
Successful Trigger Completion Evaluation Rules - Set evaluation rules for Successful Trigger Evaluation Rule.
...
Status Check
...
the Status Check
...
upon successful completion.
API Configuration:
...
In Progress Evaluation Rules:
...
Successful Completion Evaluation Rules:
...
