This gRPC-based API allows retrieving historical time and event data from ibaHD-Server. gRPC uses Protobuf both as seralization format and interface definition language. Clients for a wide range of languages can be generated from the interface definition.
- ibaHD-Server version >= 2.5.0
- ibaHD-API license on Marx dongle
This code is provided “as is” and serves as an example for the usage of ibaHD-API. The integration of ibaHD-API in external systems and general support for programming languages is not provided by iba AG. All terms of ibaHD-Server's license agreement apply.
Enable and configure ibaHD-API in ibaHD-Server
- Enable ibaHD-API
- Generate an API key (Only available when user management is enabled)
- Generate a TLS server certificate
- Export the certificate as PEM format (*.crt, *.key) for usage in the API client
Follow the guidelines of the sample clients:
The full API documentation can always be found in C:\Program Files\iba\ibaHD\ibaHD-API\ibaHD-API.proto
when ibaHD-Server is installed. It is readable with any text editor.
Depending on the programming language, the casing and naming of the fields and messages might slightly differ from the .proto definition as the Protobuf compiler applies language specific code style conventions when generating the client code.
gRPC supports a wide range of languages and platforms, see https://grpc.io/docs/languages/.
For each language a quick start and a basic tutorial is available on the gRPC website. Additionally example code matching the tutorials can be found on GitHub(e.g. Examples for Go)
The steps are similar for all languages:
-
Take the
C:\Program Files\iba\ibaHD\ibaHD-API\ibaHD-API.proto
as input for the code generation -
Generate the ibaHD-API client code, usually either by using the
protoc
Protobuf Compiler or other tooling that is referenced in the guide (e.g. Generate the client and server code for Go) -
Add generated code to your project
-
Reference the gRPC base libaries to your project (e.g. Additional imports for Go)
-
For the client code to work the following data must be set in the gRPC/ibaHD-API client:
- IP/Hostname of the machine + Port of the ibaHD-API server (default port is 9003, configurable in ibaHD manager)
- API Key (If user management is enabled)
- TLS certificate (usually in PEM format)
Additional documentation