Get Current Readings

Overview

This can be used to get the most recent current readings from compatible devices that are being managed with T&D WebStorage Service.
It is possible to get the same list of current readings that appear after having logged into T&D WebStorage Service.

*Note that info about and related to warnings is not included at this time. We are however planning to include warning information in future revisions.

Request

URI

https://api.webstorage-service.com/v1/devices/current

Access Restrictions:

Read-Only ID is also possible

Compatible Models for this API

TR-7wb/nw/wf series 、TR4 series 、RTR-500 series 、TR-700W series

Rate Limit

10 times per 120 seconds

When automatically uploading data to T&D WebStorage Service, the shortest possible uploading interval for devices such as TR-7wb/nw/wf is 1 minute.
We have designed the API so that it is possible to get the most current readings from devices like this which refresh every minute.
The rate limit allows for gaps in timing between devices, but we calculate that in most cases almost all conditions will be covered if current readings are retrieved from 2 to 5 times within a 2-minute period.

Request Header

Item NameValue
HTTP MethodPOST
X-HTTP-Method-OverrideGET
Hostapi.webstorage-service.com:443
Content-Typeapplication/json

Request Parameter

Parameter NameFormatRequiredDefault ValueDetails
api-keystring(45 characters)Yes---Already acquired API Key
login-idstring(8 characters)Yes---User ID Read-Only ID is also possible. (*1)
login-passstring(4-16 characters)Yes---The password for the above User ID.
remote-serialArray: string(8 characters)---Make entries here when wishing to select by using one or more Remote Unit Serial Numbers. It is possible to specify multiple units by using more than one array. (*1)
base-serialArray: string(8 characters)---Make entries here when wishing to select by using one or more Base Unit Serial Numbers. It is possible to specify multiple units by using more than one array. (*1)

(*1) For both “remote-serial” and “base-serial” it is possible to specify multiple units. However do not specify by using both “remote-serial” and “base-serial” at the same time. Make sure to specify by using only “remote-serial”, by using only “base-serial”, or by using neither of them to specify.
When specifying by using “remote-serial”, you are already specifying a base device and hence it is not necessary to use “base-serial”.
If specifying by serial number, even if only one serial number is specified make sure to describe as an array. (Please refer to the Request Example below.)

Request Example

Request Header

POST /v1/devices/current HTTP/1.1
Host: api.webstorage-service.com:443
Content-Type: application/json
X-HTTP-Method-Override: GET

Request Body

[1. If you wish to get device info for all devices.]
{
"api-key":"73pfobnche8d1p6laqnemsbnpkght3bjv047oid6p2sg3", 
"login-id":"tbzz9999", 
"login-pass":"ppaasswwoorrdd"
} 


[2. If you wish to get device info from multiple Remote Units by using specific Remote Unit serial numbers]
{
"api-key":"73pfobnche8d1p6laqnemsbnpkght3bjv047oid6p2sg3", 
"login-id":"tbzz9999", 
"login-pass":"ppaasswwoorrdd",
"remote-serial":["52120001","52120002"]
} 
*In this example, two sets of data are being retrieved from TR-71wf[52120001] and TR-71wf[52120002].

[3. If you wish to get device info from a specific Base Unit and its registered Remote Units by using a specific Base Unit serial number]
{
"api-key":"73pfobnche8d1p6laqnemsbnpkght3bjv047oid6p2sg3", 
"login-id":"tbzz9999", "login-pass":"ppaasswwoorrdd", 
"base-serial":["52A010D0"]
}
*In this example, all data for all Remote Units registered to our company’s demo device RTR-500AW[52A010D0] is being retrieved. 

Response

Response Header

Item NameValueDetails
HTTP status code(**)HTTP Status Code
Content-Typeapplication/json; charset=utf-8
text/csv; charset=utf-8
The format will be changed according to the specified format, either JSON or CSV. (Character code is UTF-8)
X-RateLimit-Limit(integer)Access Limit per unit of time
X-RateLimit-Reset(integer)Number of seconds per unit of time
X-RateLimit-Remaining(integer)Remaining number of accesses per unit of time

(**) If the HTTP status code is “200”, then the process has been completed successfully. If any other HTTP status code is returned, then an error has occurred and processing was not completed. If an error does occur, JSON data with the error info included will be returned.

HTTP/1.1 400 Bad Request
Server: api.webstorage-service.com
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 60
X-RateLimit-Reset: 60
X-RateLimit-Remaining: 57

{
	"error":{
		"code": error code,
		"message": "error details"
	}
}

Response Parameter

Item Name Format Required Details
devices Array Yes Device (Remote Unit) Info shown here as an array in which the number of elements equals the number of devices.
If there is a combination of Base Units and Remote Units, only the Remote Unit Info is included.
  devices.num number Yes Device (Remote Unit) Number shown here. In the case of an independently operating device (no Base required), then fixed at “0”.
  devices.serial string(8 characters) Yes Device (Remote Unit) Serial Number
  devices.model string(32 characters) Yes Device (Remote Unit) Model Name
  devices.name string(32 characters) Yes Device (Remote Unit) Device Name
  devices.battery number Yes Device (Remote Unit) Battery Level
TR-7wb/nw/wb series
  1: Very low - change now | 2: Low - change soon | 3: Getting Low | 4: Medium | 5: High
RTR-500 series/TR4 series
  1-3: Very low - change now | 4: Low - change soon | 5: High
  devices.rssi number Device (Remote Unit) Radio Signal Strength
  devices.time-diff number Yes Device Time Difference Info [in units of minutes] shown here. If it is a Remote Unit, then the time difference info will be that set in Base Unit to which it is registered.
  devices.std-bias number Yes Device Time Difference from Standard [in units of minutes] shown here. If it is a Remote Unit, then the time difference from standard info will be that set in Base Unit to which it is registered.
  devices.dst-bias number Yes Device Time Difference during Daylight Savings Time [in units of minutes] shown here. If it is a Remote Unit, then the time difference during daylight savings time info will be that set in Base Unit to which it is registered.
  devices.unixtime number Yes Device (Remote Unit) Clock Time of Most Recent Measurement (unixtime)
  devices.channel Array Yes Device (Remote Unit) Measurement Channel Info shown here. Array in which the number of measurement channels is the number of elements.
    devices.channel.num number Yes Channel Number
    devices.channel.name string(32 characters) Channel Name
    devices.channel.value string Yes Most Recent Measurement Reading shown here. If a communication error occurs, an error message will be entered and will not be handled as a numerical value but will be treated as characters.
    devices.channel.unit string(20 characters) Yes Unit of Measurement shown here. If scale conversion is taking place, then the value will be the post converted measurement value.
  devices.baseunit Array Yes Base Unit Info shown here. Array in which the number of Base Units is the number of elements.
Even if it is an independently operating device (no Base required), the device info will be entered as if it were a Base Unit.
    devices.baseunit.serial string(8 characters) Yes Base Unit Serial Number (if it is an independently operating device (no Base required), then it will be that device’s serial number)
    devices.baseunit.model string(32 characters) Yes Base Unit Model Name (if it is an independently operating device (no Base required), then it will be that device’s model name)
    devices.baseunit.name string(32 characters) Yes Base Unit Device Name (if it is an independently operating device (no Base required), then it will be the device name of that device)
  devices.group Array Yes Group Info shown here. Array in which the number of groups is the number of elements.
Even if there are devices with no Group settings, the number “0” will treated as one element.
    devices.group.num number Yes Group Number (If it is a device with no Group settings, then fixed at “0”. )
    devices.group.name string(16 characters) Group Name (If it is a device with no Group settings, then blank data.)

* “Independently operating devices” refers to such devices as in the TR-7wb/nw/wf Series, TR4 Series, and the TR-700w series which can send data to T&D WebStorage Service acting alone without a Base Unit.

Response Example

{
	"devices": [{
			"num": "2",
			"serial": "52BC078B",
			"model": "RTR-503",
			"name": "02",
			"battery": "5",
			"rssi": "5",
			"time_diff": "540",
			"std_bias": "0",
			"dst_bias": "0",
			"unixtime": "1476150408",
			"channel": [{ 
					"num": "1",
					"name": "",
					"value": "23.9", 
					"unit": "C"
				}, {
					"num": "2",
					"name": "",
					"value": "40",
					"unit": "%"
				}
			],
			"baseunit": {
				"serial": "529C0051",
				"model": "RTR-500NW",
				"name": "RTR-500NW_529C0051"
			},
			"group": {
				"num": "0",
				"name": "Group1"
			}
		},{
			"num": "1",
			"serial": "52BC1495",
			"model": "RTR-503",
			"name": "01",
			"battery": "5",
			"rssi": "5",
			"time_diff": "540",
			"std_bias": "0",
			"dst_bias": "0",
			"unixtime": "1476150411",
			"channel": [{
					"num": "1",
					"name": "",
					"value": "23.9",
					"unit": "C"
				}, {
					"num": "2",
					"name": "",
					"value": "39",
					"unit": "%"
				}
			],
			"baseunit": {
				"serial": "529C0051",
				"model": "RTR-500NW",
				"name": "RTR-500NW_529C0051"
			},
			"group": {
				"num": "0",
				"name": "Group1"
			}
		}
	]
}

MENU