# 查询设备历史命令
Request format: **GET**

URL:http(s)://api.heclouds.com/cmds/history/{device_id}

Note: device_id needs to be replaced with the device ID.

[I only want to see examples！！！](#1)

#### Url parameter

<table>
<tr><th width="15%">Parameter Name</th><th width="15%">Format</th><th width="15%">Required?</th><th>Description</th></tr>
<tr><td>start</td><td>date</td><td>Yes</td><td>Start time of the query, format example:2019-10-10T08:00:35</td></tr>
<tr><td>end</td><td>date</td><td>No</td><td>The end time of the query, format example:2019-10-10T08:00:35</td></tr>
<tr><td>page</td><td>int</td><td>No</td><td>Specify page number</td></tr>
<tr><td>per_page</td><td>int</td><td>No</td><td>Specify the number of output devices per page, the default is 30, and the maximum is 100</td></tr>
</table>

#### HTTP request Return Parameters

<table>
<tr><th width="15%">Name</th><th width="15%">Format</th><th width="70%">Description</th></tr>
<tr><td>errno</td><td>int</td><td>Call error code, where 0 means success.</td></tr>
<tr><td>error</td><td> string</td><td>Error description, where "succ" means success.</td></tr>
<tr><td>data</td><td>json</td><td>Device dependent message returned after the interface is successfully invoked; see Data Description Table</td></tr>
</table>

#### Data Description Table

<table>
<tr><th width="15%">Name</th><th width="15%">Format</th><th width="70%">Description</th></tr>
<tr><td>page</td><td>int</td><td>Current page number</td></tr>
<tr><td>per_page</td><td>int</td><td>Number of devices per page</td></tr>
<tr><td>total_count</td><td>int</td><td>Total</td></tr>
<tr><td>items</td><td>array-json</td><td>For information about device history commands, see items description table</td></tr>
</table>

#### items Description Table

<table>
<tr><th width="15%">Name</th><th width="15%">Format</th><th width="70%">Description</th></tr>
<tr><td>cmd_uuid</td><td>string</td><td>Command ID</td></tr>
<tr><td>device_id</td><td>string</td><td>Device ID</td></tr>
<tr><td>expire_time</td><td>date</td><td>Expiration</td></tr>
<tr><td>status</td><td>int</td><td>Command status</td></tr>
<tr><td>send_time</td><td>date</td><td>Send time</td></tr>
<tr><td>confirm_time</td><td>date</td><td>Response time</td></tr>
<tr><td>confirm_body</td><td>string</td><td>Response content，Hexadecimal characters</td></tr>
<tr><td>body</td><td>string</td><td>Request content，Hexadecimal characters</td></tr>
</table>

<h4 id="1">Request Example</h4>

```text
GET http://api.heclouds.com/cmds/history/3****78?start=2015-01-10T08:00:35 HTTP/1.1
```

#### Return example
```json
{
	"errno": 0,
	"error": "succ",
	"data": {
		"page": 1,
		"per_page": 10,
		"total_count": 100,
		"items": [{
				"cmd_uuid": "2302-312-21dgaapbafddfs",
				"device_id": 223422,
				"expire_time": "2016-07-05 00:00:00",
				"send_time": "2016-07-05 00:00:00",
				"confirm_time": "2016-07-05 00:00:00",
				"confirm_body": "2463726571007b202274797022",
				"body": " 2463726571007b202274797022"
			},{
				"cmd_uuid": "rezcgt2-se12-F2323Wdadfadfs",
				"device_id": 223422,
				"expire_time": "2016-07-05 01:01:01",
				"send_time": "2016-07-05 03:01:02",
				"confirm_time": "2016-07-05 02:02:02",
				"confirm_body": "2463726571007b202274797022",
				"body": " 2463726571007b202274797022"
			},{...}
		]
	}
}
```

#### [< Cancel cache command](/book/application-develop/list/14cancel-cache-comm.md)
#### [<div style="text-align: right">Add trigger ></div>](/book/application-develop/list/15add-trigger.md)