HTTP Request Addressing

When sending REST-style HTTP requests using the realm server web API, address them to URIs with one of these prefixes:

http://host:port/api/v1/

https://host:port/api/v1/

• host:port is the realm server's connect port (--http parameter).
• v1 denotes the version of the realm server web API. This version number could change in subsquent releases.

For example, using the curl utility:

curl -X GET http://host:port/api/v1/clients

curl -X POST http://host:port/api/v1/server --data '{"cmd":"shutdown"}'

For brevity, this document omits the prefix, but you must supply it. For example:

• The documentation for the request GET clients implies that you would send a GET request to this URI:

  http://host:port/api/v1/clients

• The documentation for the request POST realm/transports/name implies that you would send a POST request to this URI:

  http://host:port/api/v1/realm/transports/name

  (Substitute the actual transport name for the variable name.)