Every OTbase Asset Discovery node comes with an integrated REST API that allows you to make configuration changes (such as changing access credentials for WMI or SNMP) programatically.
The REST API is particularly useful if you are operating hundreds of Asset Discovery nodes, and applying configuration changes manually e.g. via OTbase Discovery Manager proves too time consuming.
Connecting to the REST API
In order to connect to the REST API of an Asset Discovery node, open an HTTPS connection to the node's IP address and the TCP port you have configured (default: 443).
HTTPS means that your data is encrypted on transport. Asset Discovery uses a self-signed certificate, so your client software will probably notify you that the authenticity of the server cannot be verified or that the certificate is expired. Since Asset Discovery is intended to run only in trusted networks, we suggest to ignore such a warning. HTTPS is used here only for encryption, not for authentication.
After connection establishment you have to authenticate either using Basic Authentication or OAuth2. Authentication via an LDAP account is not possible. For Basic Authentication, use the user ID and password that you have configured for the node. Configuring OAuth is explained in a separate chapter in this section.
|Change configuration / trigger an action
Note: The content type for the body is always application/json.
|Successfully processed the request, includes a response body
|Accepted the request but processing is not completed
|Successfully processed the request, without a response body
|An error occurred. See the response body for more information
|Resource not found. See the response body for more information
|Method not allowed. See the response body for more information