Sends a HTTP REST request to the specified Miniserver and returns the status code and value, and also the raw content of the response.

This function is the "raw", generic Miniserver REST function. To send or query data, you should prefer LoxBerry::IO::mshttp_send and LoxBerry::IO::mshttp_get.

The first parameter is the Miniserver number (numbers are equal to LoxBerry::System::get_miniservers, starting with 1).

The second parameter is a string with the full command, but without hostname, e.g. /dev/sps/io/Livingroom/state.

The function returns three values: The queried "value" (string), The status code (string), and the raw response as string. 

Status codes not in the 2xx range (below 200 and from 300 upwards) are an error. Normally, Loxone returns a "code" 200 for ok.

As Loxone Miniserver most commonly returns a HTTP statuscode of "200 OK" in the HTTP header - also with wrong syntax or non-existing elements, the function parses the result and returns the "code", a value the Miniserver returns inside of the response. 

Therefore, the function may return

• a LoxBerry-own "error code" in the 6xx area (e.g. "601" for "Miniserver not defined")
• the HTTP statuscode, if a real HTTP header errorcode is returned
• the Loxone "code" of the response
  • 500 "Server Error" for errors, e.g. if the request syntax was wrong, or the requested block does not exist
  • 403 "Forbidden" if the block exists but the defined user has no access to this block (Loxone user permissions)
• 200 if the request was successful

use LoxBerry::IO;
# Only value
my ($value) = mshttp_call(1, "/dev/sps/io/Light_Livingroom/state");
 
# Value with code
my ($value, $status) = mshttp_call(1, "/dev/sps/io/Light_Livingroom/state");
if ($status ne "200") {
    print STDERR "Error retrieving from Miniserver";
} else {
    print STDERR "Value is $value.";
}
 
# Raw data
my (undef, $status, $resp) = mshttp_call(1, "/dev/sps/io/Energymeter_Washingmachine/state");
print " status: " . $status;
print " raw: " . $resp;