Authentication
To authenticate HTTP requests, you need to use AKSM-Auth, which is the authentication credential. For more information about HTTP authentication, see HTTP Authentication.
HTTP headers
Below is an overview of important HTTP headers:
- Accept: The media type(s) that are acceptable for the response. See Content negotiation.
- Content-Length: The length of the request's content in octets (8-bit bytes).
- Accept-Charset: Acceptable character set (utf-8, utf-16, etc.).
- Content-Type: The media type of the request's content (used with POST and PUT).
- Accept-Encoding: List of acceptable compression methods (e.g. gzip).
Guidelines for commands
- Commands will only work with a valid username and password, and the SM800A authorisation level allows configuration changes.
- All requests should contain the attribute
units=to identify data returned in US or SI units.
Tip: Use
the units= attribute to specify the unit type in data processing requests.Time delay between requests
To ensure correct data handling, there must be a minimum delay of 4 seconds between receiving a response and sending the next request.
Note: To read multiple values most efficiently, it is recommended to use the
read_val command, which can read up to 100 parameters in a single request. Remember to pause for 4 seconds before the next request.Single request with multiple devices
It is possible to request parameters from different devices in a single read_val request, simplifying the process when working with multiple devices.