Balluff BNI EIP-508-105-Z067, Configuration Manual

Page: 85 / 88

www.balluff.com 41 english
6
WebUI/web interface (continued)
Link to the official documentation ( JSON for IO-Link ) in
the general download area of the IO-Link community:
https://io-link.com/de/Download/Download.php >
IO-Link Integration area > JSON Integration for IO-Link
(ZIP file)
Base path of the REST API in the module:
http://[ip-address]/iolink/v1/
The JSON for IO-Link REST API also specifies the
possibility of configuring an MQTT Publisher. This
function is not implemented in the current version
of this module.
The specification JSON for IO-Link REST API
describes a further functionality for process data
and parameters, which requires IODD support.
This functionality is also not fully implemented in
the current version.
The module only supports uploading of IODDs.
Writing/reading process data or parameters with
their names is not supported.
Some examples below explain how REST API is applied.
– GET requests (chapter 6.8.2 bis 6.8.4) can be
executed without login, as no system changes or
modifications are made.
– POST methods (chapters 6.8.5 and 6.8.6) require the
use of a login.
6.8.1 Login
Login is possible by entering the following address:
http://[ip-address]/api/balluff/v1/users/login
A JSON object is also specified, in which, as shown below,
a user name and password are specified (see
chapter 6.3.5 on page 27):
{
“username”: “[username]”,
“password”: “[password]”,
}
If the login was successful, you receive a token in the form
of a JSESSIONID, such as:
{
“JSESSIONID”: “ 7euh07tdfawjej”
}
This token can now be used below to implement POST
methods. A corresponding request can be equipped with
the header
Authorization: Bearer
7euh07tdfawjej
.
6.8.2 Requesting the device identification of the
module
The device identification data of an IO-Link master can be
requested via the following addresses:
– http://[ip-address]/api/balluff/v1/identification
– http://[ip-address]/iolink/v1/masters/1/identification
In the event of a successful request, an answer is supplied
in the form of a JSON object with parameters such as the
vendorID , the serialNumber of the firmwareRevision of the
respective IO-Link master.
Fig. 6-40: Requesting the device identification
BNI EIP-508-105-Z067
Network interface