¶ Requirements
- Admin+ Feature Pack.
- Enable the ThinManRoot user.
- Minimum required version: ThinMan 8.7.1.
¶ ThinMan Local Users
To access the Asset Inventory data, it is necessary to create at least one ThinMan local user.
¶ Activiting the functionality
Go to Tools menu and select API Inventory.
It will open the API Inventory window.
Click on Enable API to activate the REST API to extract inventory information from the ThinMan WEB server. This data can be utilized in third-party Asset Management tools.
If the Local Users list appears empty, you need to add at least one ThinMan Local User.
Click on Add Local User. Write the username and password and click on OK.
Then, select the ThinMan Local Users you want to authorized to access the API.
¶ Output
The inventory data is collected in JSON format.
Two types of output are available: Standard and Full.
¶ Access the Inventory data
¶ Standard Mode
To get the inventory data in standard mode, use a browser with the address: https://<fqdn>/api/v1/devices? where the <fqdn> corresponds to the FQDN of the ThinMan server.
It will ask for credentials, use one of the authorized ThinMan local users to access the information.
¶ Full Mode
To get the inventory data in the full mode, use the address: https://<fqdn>/api/v1/devices?details=full
¶ Filtered Devices Data
¶ Single Device
To get the details of a single device, add to the Standard Mode URL id=mac%23mac_address where mac_address is the device's MAC address. E.g. https://<fqdn>/api/v1/devices?id=mac%2300E0C5112433
¶ List of Devices
To get the details of two or more devices, add to the Standard Mode URL id=mac%23mac_address&id=mac%23mac_address&id=mac%23mac_address... where MAC_ADDRESS is the device's MAC address. E.g. https://<fqdn>/api/v1/devices?id=mac%2300E0C5112233&id=mac%2300E0C5445566
¶ Calling the API
HTTP https://user:password@<fqdn>/api/v1/devices
CURL curl.exe -u user:password https//:\<fqdn>/api/v1/devices