Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Home
  • Knowledge base
  • Contact Us
  • Home
  • Configuration in the Web UI
  • Tools & Add-ons

Shadow API (Proxy API to SIA)

How to utilize the internal API of SIA remotely using the Shadow API

Written by Ioannis Panteleakis

Updated at February 4th, 2022

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Installation & Technical information
    Introduction SIA Connect Standalone SIA Connect ANY-Ware Cellular & WiFi connectivity
  • Configuration in the Web UI
    Getting started with the UI Connectors Instances Items Mapping Data System Network Tools & Add-ons DigiCert IoT Trust Manager
  • Connectors
    Siemens S7 Azure IoT Ethernet/IP Mitsubishi MELSEC OPC-UA Server SQL MQTT Omron Host Link REST API Omron FINS Keyence Beckhoff TwinCAT BACnet Virtual OPC-UA Client MS SQL File M-Bus Modbus
  • Scripting & Variables
    Data formatting
  • Developers
    API documentation Shadow API
  • Tutorials & Guides
    InfluxDB AWS IoT Core - Amazon Web Services Microsoft Power BI KaaIoT Siemens S7 AVEVA Insight SIA Connect Demo Rack Grafana Azure
  • General
+ More

Articles in this section:

  • Shadow API (Proxy API to SIA)
  • Ping tool
  • Internal REST API Reference

Table of Contents

IntroductionDescription

Introduction

ShadowAPI is a tool that allows SIA to expose its internal API‍ using the MQTT protocol as a way to forward requests. 

It can help especially in situations where the user wants to access the API and SIA is running behind a firewall, or an environment with restricted HTTP access. Hence acting as a API proxy forwarder which allows remote access to the API.


For developer setup and use instructions, please follow this guide‍.


Description

In order to make use of the ShadowAPI, a MQTT Broker is required to which SIA needs to be able to connect to, either in the local network or the internet.

The MQTT broker configuration can be set on the SIA Web interface, under the tools section.

After setting up the MQTT broker fields, a connection to it should be successful.

Then, any queries can be sent to the MQTT broker (in a specific format) in order to interface with the SIA API. The ShadowAPI will listen to the MQTT broker, receive the query, process it and finally, return a response to the Broker.

There are 2 main types of channels (topics). One topic which is used by the client to send HTTP requests meant for the SIA API and another topic for the corresponding responses.

Every request reflects a message format which is described ShadowAPI‍ developer section. Responses follow the same exact format.


For developers

Read more detailed information regarding the technical use at the ShadowAPI‍ developer section.


intermediary api silhouette api

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Using the Shadow API
  • Internal REST API Reference

0
0
Expand