Skip to main content

FairCom Edge API reference

The FairCom Edge API manages the actions that configure FairCom Edge. It is based on the jsonAction protocol, which sends JSON requests to a server and returns JSON responses. This section defines the JSON payloads that can be sent to the FairCom server over HTTP, HTTPS, WS, and WSS using the endpoint /api, such as https://localhost:8443/api.

The following sections are a listing of all available actions for configuring FairCom Edge.

Important

When using the Property summary tables, if there is additional information that the Property summary tables do not provide the property has a link to the property topic that contains the comprehensive explanation.

Sessions

Services

Integration tables

These actions are part of the JSON Hub API. This section provides several actions to alter, create, delete, describe, and list integration tables.

Action

Description

"alterIntegrationTable"

"alterIntegrationTable" alters table settings that are safe to modify, such as adding new fields.

"createIntegrationTable"

"createIntegrationTable" creates an integration table.

"deleteIntegrationTables"

"deleteIntegrationTables" deletes an integration table as long as there are no dependencies on it.

"describeIntegrationTables"

"describeIntegrationTables" returns all available information about each specified integration table.

"listIntegrationTables"

"listIntegrationTables" lists only the integration tables in a given database.

Transforms

These actions are part of the JSON MQ API. This section provides several actions to alter, create, delete, describe, and list transforms.

Action

Description

"alterTransform"

"alterTransform" renames and/or edits the properties of an existing transform process.

"createTransform"

"createTransform" creates a transform and saves it by name for reuse in MQTT topics and inputs.

"deleteTransform"

"deleteTransform" deletes one or more transforms and returns a full description of each deleted transform so that the transform can be recreated easily.

"describeTransforms"

"describeTransforms" returns all available information about each specified transform.

"listTransforms"

"listTransforms" obtains a list of the names of existing transforms.

Topics

These actions are part of the JSON MQ API. This section provides several actions the configure, delete, describe, and list topics.

Action

Description

"configureTopic"

"configureTopic" configures an existing MQTT topic or creates a new one.

"deleteTopic"

"deleteTopic" deletes an MQTT topic.

"describeTopics"

"describeTopics" returns all available information about specified MQTT topics.

"listTopics"

"listTopics" lists the names of MQTT topics that the server is tracking.

Broker connections

These actions are part of the JSON MQ API. This section provides actions to configure, delete, describe, and list broker connections.

Action

Description

"configureBrokerConnection"

"configureBrokerConnection" creates or updates a reusable connection to an external broker, which may be another instance of FairCom MQ, FairCom Edge, or an MQTT broker from another vendor.

"deleteBrokerConnection"

"deleteBrokerConnection" deletes a previously created broker connection.

"describeBrokerConnections"

"describeBrokerConnections" returns information about specified broker connections.

"listBrokerConnections"

"listBrokerConnections" lists all available broker connections that have been created.

Inputs

These actions are part of the JSON Hub API. This section provides several actions to alter, create, delete, describe, and list inputs.

Action

Description

"alterInput"

"alterInput" modifies the configuration of an existing input.

"createInput"

"createInput" creates a new input.

"deleteInput"

"deleteInput" removes a previously created input definition as long as no output definitions are using it.

"describeInputs"

"describeInputs" returns all available information about each specified input.

"listInputs"

"listInputs" obtains a list of names of previously created inputs.