Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Improved descriptions to fully match with the current implementation

Init external flow 

Code Block
languagejs
POST /api/v2/session/{sessionId}/externalflow/init

{"configurationId": "{configurationId}}"

Description

Initialises Initializes the external container component on the HOST runtime.

Parameters

URL SegmentExpected TypeDescription
sessionIdAquimaSessionSession for which the external container was expanded.
The

Request body

must be JSON containing the configuration ID property name configurationId with a value of type string.

Example

Response

response

If successful, status 200 OK and response body

Code Block
{
	"configurationId" : "123-456-789"
}

Start external flow 

Code Block
languagejs
POST /api/v2/externalflow/start

{"configurationId": "{configurationId}}"

Description

Starts the external flow container on the TARGET runtime.

Parameters

None

Request body

JSON containing property name configurationId with a value A JSON containing the configuration ID of type string.

Example

Response

response

If successful, status 200 OK and response body

Code Block
{
	"sessionId" : "123-456-789"
}

Complete external flow 

Code Block
languagejs
POST /api/v2/session/{sessionId}/externalflow/{configurationId}/complete

Description

Completes the external flow and executes the mapping between the interface and source profile. This endpoint should be called on the HOST runtime.

Parameters

URL SegmentExpected TypeDescription
sessionIdAquimaSessionThe Id of the AquimaSession from the host runtime.  
configurationIdstringUnique Automatically generated unique id for the external flow container configuration.
Example Response

Request body

Code Block
{
   "parameters": {
     <param1_name>: ["value1","value2"]
   },
   "elementKey": <elementKey>,
   "fields": [
     {
       "key": <key>,
       "values": ["value1", "value2"]
     }
   ]
}


Example response

If successful, status 200 OK and response body

Code Block
{
   "events": [
      {
       	"sessionId": <sessionId>,
     	"changes": {"changes": []},
      	"type": "page"
      }, 
	  ...
	]
}

End external flow 

Code Block
languagejs
POST /api/v2/session/{sessionId}/externalflow/{configurationId}/end

Description

Closes the external session. This endpoint should be called on the TARGET runtime.

Parameters

URL SegmentExpected TypeDescription
sessionIdAquimaSessionThe Id of the AquimaSession from the target runtime.  
configurationIdstringUnique Automatically generated unique id for the external flow container configuration.

Request body

None

Response

If successful, status code 200 OK

The

Table of Contents