Evok

The Evok is our Open-Source application programming interface (API) providing interfaces to access physical inputs, outputs and communication interfaces. Its goal is to provide simple access to the hardware without the need to deal with low-level programming.

Documentation, installation guide and description of APIs can be found at our GitHub repository.

Evok is divided into two modules:

1. Evok - the core handling the communication between all APIs and the hardware
2. Evok Web (optional) - a practical example of some of the APIs in a Web-based application which also serves as a simple UI of all I/Os of the unit

Application logic and other operations (implementation of different components of the system) should be handled by an external application.

• REST
• REST JSON
• WebSocket
• BULK
• Webhook
• JSON-RPC

Documentation, such as how to install or configure, is available on Read the Docs. The API itself is documented on the Stoplight, a few examples are below.

Quick examples using curl and JSON:

• Returning the state of digital input DI 1_01:

  curl --request GET --url http://<your-ip>:8080/json/di/1_01 --header 'Accept: text/html, application/json'

• Switch-on the RO 2_01 relay:

  curl --request POST --url http://192.168.1.2:8080/json/do/2_01 --header 'Accept: application/json' --header 'Content-Type: application/json' --data '{"value": 1}'

• Switch-off the RO 2_01 relay:

  curl --request POST --url http://192.168.1.2:8080/json/do/2_01 --header 'Accept: application/json' --header 'Content-Type: application/json' --data '{"value": 0}'

Legacy documentation of Evok v2 is available here, API documentation is also available.