This section details the specifications and usage of the RESTful API for the iBoot-PDU family of power
distribution units. It allows users to get outlet status and control outlets using HTTP and HTTPS.
The system relies on an authentication token to provide additional security.
10.1. Authorization Token
An authorization token is required prior to any further communication. The token is valid until there is 5
minutes of inactivity between the client and the iBoot-PDU. Each time the RESTful API is accessed using
the token this 5 minute timeout will reset.
Acquire the token from the iBoot-PDU at
https://<ipaddress>/services/auth/ or
http://<ipaddress>/services/auth/
where <ipaddress> is the IP Address of the iBoot-PDU
The authorization request requires a username and password that is valid for the iBoot-PDU being
accessed. The authorization request uses the following JSON structure:
{
"username":"<username>",
"password":"<password>"
}
Upon receiving an authorization request, the iBoot-PDU will issue a response with the following JSON
structure:
{
"success":"<true|false>",
"message":"<message>",
"token":"####-####-####-####"
}
success returns true or false based on the successful receipt of the authorization request
message is an error message to assist in debugging when success is false
token is the 64-bit code to allow further communication with the iBoot-PDU
Example – using CURL
curl --data '{"username":"Jeff", "password":"jeffpass"}' -X POST http://10.10.10.30/services/auth/
Authorization Response:
{"success":"true","message":"","token":"7594-235E-E439-69D3"}
iBoot-PDU_v230829w
10.
RESTful API
//PDU Username
//PDU Password
//Result code true or false
//Error Message from the server. Specific for error
//64 bit randomly generated token
Authorization Request:
iBoot-PDU User Manual
Page 75
Need help?
Do you have a question about the iBoot-PDU4-N15 and is the answer not in the manual?
Questions and answers