Industry Protocol Details (API)

20KB

Protocol Mapper Schema.yaml

Open

Get all connection schemas

get

Authorizations

ApiKeyHeader

Responses

200

Connection schemas

application/json

get

/connections/schema

HTTPcURLJavaScriptPython

GET /api/connections/schema HTTP/1.1
Host: 
Accept: */*

200

Connection schemas

{}

Get all connections

get

Authorizations

ApiKeyHeader

Responses

200

Array of connections

application/json

500

Failed to list all connections

get

/connections

HTTPcURLJavaScriptPython

GET /api/connections HTTP/1.1
Host: 
Accept: */*

[
  {
    "id": "text",
    "currentState": "connecting",
    "targetState": "connected",
    "connection": {},
    "agentName": "text"
  }
]

Get one connection by id

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got a connection

application/json

500

Failed to get connection

get

/connections/{id}

HTTPcURLJavaScriptPython

GET /api/connections/{id} HTTP/1.1
Host: 
Accept: */*

{
  "id": "text",
  "currentState": "connecting",
  "targetState": "connected",
  "connection": {},
  "agentName": "text"
}

Update an existing connection

put

Authorizations

ApiKeyHeader

Body

application/json

operationstring · enumRequiredPossible values:

Responses

200

Updated connection

application/json

500

Failed to update the connection

put

/connections/{id}/operation

HTTPcURLJavaScriptPython

PUT /api/connections/{id}/operation HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "operation": "connect"
}

{
  "id": "text",
  "currentState": "connecting",
  "targetState": "connected",
  "connection": {},
  "agentName": "text"
}

Get all endpoint schemas

get

Authorizations

ApiKeyHeader

Responses

200

Endpoint schemas

application/json

get

/endpoints/schema

HTTPcURLJavaScriptPython

GET /api/endpoints/schema HTTP/1.1
Host: 
Accept: */*

200

Endpoint schemas

{}

Get all endpoints

get

Authorizations

ApiKeyHeader

Responses

200

Array of endpoints

application/json

500

Failed to list all endpoints

get

/endpoints

HTTPcURLJavaScriptPython

GET /api/endpoints HTTP/1.1
Host: 
Accept: */*

[
  {
    "id": "text",
    "currentState": "enabling",
    "targetState": "enabled",
    "connectionId": "text",
    "operation": "text",
    "address": {},
    "agentName": "text"
  }
]

Get one endpoint by id

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got an Endpoint

application/json

500

Failed to get endpoint

get

/endpoints/{id}

HTTPcURLJavaScriptPython

GET /api/endpoints/{id} HTTP/1.1
Host: 
Accept: */*

{
  "id": "text",
  "currentState": "enabling",
  "targetState": "enabled",
  "connectionId": "text",
  "operation": "text",
  "address": {},
  "agentName": "text"
}

Get one endpoint topics by id

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got an Endpoint topics

application/json

500

Failed to get endpoint topics

get

/endpoints/{id}/topics

HTTPcURLJavaScriptPython

GET /api/endpoints/{id}/topics HTTP/1.1
Host: 
Accept: */*

[
  "text"
]

Get one endpoint state by id

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got an Endpoint state

application/json

500

Failed to get endpoint state

get

/endpoints/{id}/state

HTTPcURLJavaScriptPython

GET /api/endpoints/{id}/state HTTP/1.1
Host: 
Accept: */*

text

Update an existing endpoint

put

Authorizations

ApiKeyHeader

Body

application/json

operationstring · enumRequiredPossible values:

Responses

200

Updated endpoint

application/json

500

Failed to update the endpoint

put

/endpoints/{id}/operation

HTTPcURLJavaScriptPython

PUT /api/endpoints/{id}/operation HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "operation": "enable"
}

{
  "id": "text",
  "currentState": "enabling",
  "targetState": "enabled",
  "connectionId": "text",
  "operation": "text",
  "address": {},
  "agentName": "text"
}

Get all mapping schemas

get

Authorizations

ApiKeyHeader

Responses

200

Mapping schemas

application/json

get

/mappings/schema

HTTPcURLJavaScriptPython

GET /api/mappings/schema HTTP/1.1
Host: 
Accept: */*

200

Mapping schemas

{}

Get all mappings

get

Authorizations

ApiKeyHeader

Responses

200

Array of mappings

application/json

500

Failed to list all mappings

get

/mappings

HTTPcURLJavaScriptPython

GET /api/mappings HTTP/1.1
Host: 
Accept: */*

[
  {
    "id": "text",
    "currentState": "enabling",
    "targetState": "enabled",
    "mappings": [
      {}
    ],
    "agentName": "text"
  }
]

Get one mapping by id

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got an Mapping

application/json

500

Failed to get mapping

get

/mappings/{id}

HTTPcURLJavaScriptPython

GET /api/mappings/{id} HTTP/1.1
Host: 
Accept: */*

{
  "id": "text",
  "currentState": "enabling",
  "targetState": "enabled",
  "mappings": [
    {}
  ],
  "agentName": "text"
}

Update an existing mapping

put

Authorizations

ApiKeyHeader

Body

application/json

operationstring · enumRequiredPossible values:

Responses

200

Updated mapping

application/json

500

Failed to update the mapping

put

/mappings/{id}/operation

HTTPcURLJavaScriptPython

PUT /api/mappings/{id}/operation HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "operation": "enable"
}

{
  "id": "text",
  "currentState": "enabling",
  "targetState": "enabled",
  "mappings": [
    {}
  ],
  "agentName": "text"
}

Get endpoint topics for a given mapping

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got the Mapping endpoint topics

application/json

500

Failed to get mapping endpoint topics

get

/mappings/{id}/endpoint-topics

HTTPcURLJavaScriptPython

GET /api/mappings/{id}/endpoint-topics HTTP/1.1
Host: 
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": [
    "text"
  ]
}

Get one mapping state by id

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got an Mapping state

application/json

500

Failed to get mapping state

get

/mappings/{id}/state

HTTPcURLJavaScriptPython

GET /api/mappings/{id}/state HTTP/1.1
Host: 
Accept: */*

text

Get all server schemas

get

Authorizations

ApiKeyHeader

Responses

200

Server schemas

application/json

get

/servers/schema

HTTPcURLJavaScriptPython

GET /api/servers/schema HTTP/1.1
Host: 
Accept: */*

200

Server schemas

{}

Get all servers

get

Authorizations

ApiKeyHeader

Responses

200

Array of servers

application/json

500

Failed to list all servers

get

/servers

HTTPcURLJavaScriptPython

GET /api/servers HTTP/1.1
Host: 
Accept: */*

[
  {
    "id": "text",
    "options": {},
    "currentState": "enabling",
    "targetState": "enabled",
    "protocol": "Opcua",
    "agentName": "text"
  }
]

Get one server by id

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got a Server

application/json

404

Server not found

500

Failed to get server

get

/servers/{id}

HTTPcURLJavaScriptPython

GET /api/servers/{id} HTTP/1.1
Host: 
Accept: */*

{
  "id": "text",
  "options": {},
  "currentState": "enabling",
  "targetState": "enabled",
  "protocol": "Opcua",
  "agentName": "text"
}

Update an existing servers

put

Authorizations

ApiKeyHeader

Body

application/json

operationstring · enumRequiredPossible values:

Responses

200

Updated server

application/json

500

Failed to update the server

put

/servers/{id}/operation

HTTPcURLJavaScriptPython

PUT /api/servers/{id}/operation HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "operation": "enable"
}

{
  "id": "text",
  "options": {},
  "currentState": "enabling",
  "targetState": "enabled",
  "protocol": "Opcua",
  "agentName": "text"
}

Get one server state by id

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got a Server state

application/json

500

Failed to get server state

get

/servers/{id}/state

HTTPcURLJavaScriptPython

GET /api/servers/{id}/state HTTP/1.1
Host: 
Accept: */*

text

Get all nodes

get

Authorizations

ApiKeyHeader

Responses

200

Array of nodes

application/json

500

Failed to list all nodes

get

/nodes

HTTPcURLJavaScriptPython

GET /api/nodes HTTP/1.1
Host: 
Accept: */*

[
  {
    "id": "text",
    "currentState": "enabling",
    "targetState": "enabled",
    "nodes": [
      {}
    ],
    "agentName": "text"
  }
]

Get one node state by id

get

Authorizations

ApiKeyHeader

Responses

200

Sucessfully got an Node state

application/json

500

Failed to get node state

get

/nodes/{id}/state

HTTPcURLJavaScriptPython

GET /api/nodes/{id}/state HTTP/1.1
Host: 
Accept: */*

text

Get all available topics

get

Authorizations

ApiKeyHeader

Responses

200

Topics organized by their associated resources

application/json

500

Failed to list all available topics

get

/topics

HTTPcURLJavaScriptPython

GET /api/topics HTTP/1.1
Host: 
Accept: */*

{
  "endpoints": [
    {}
  ],
  "mappings": [
    {}
  ],
  "nodes": [
    {}
  ]
}

Execute rule engine transformation

post

Authorizations

ApiKeyHeader

Body

application/json

inputobject | array | string | null | number | booleanRequired

The body being inputted for transformation

transformationstringRequired

The transformation expression

Responses

200

Transformed output

application/json

500

Failed to transform input

post

/rule-engine/transform

HTTPcURLJavaScriptPython

POST /api/rule-engine/transform HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "input": null,
  "transformation": "text"
}

{}