历史数据查询,该API用于从 IoT区块链可信应用系统查询历史数据 。

1. 当传递时间参数时开始时间和结束时间,最大查询区间为 30天 。

2. 当未传递时间参数时,限制数据量最大为500条,如超过该条数限制需添加时间戳参数方式查询。

可访问账号:

业务管理方

业务使用方

请求参数

名称 类型 是否必选 示例值 描述
Action String GetHistoryDataList

系统规定参数。取值:GetHistoryDataList。

ApiVersion String 1.0.0

API版本号,"1.0.0"。

CurrentPage Integer 1

指定显示返回结果中的第几页,最小取值是1。

Key String 0001_HB5jyvZWzwcM****_0X**_80aa976ac4d64a97bd45c71a509d****

数据Key唯一标识。

PageSize Integer 2

指定返回结果中每页显示的记录数量,最大值是100。

ProductKey String HB5jyvZWzwcM****

业务链编码。

StartTime Long 1608010000000

起始时间戳。毫秒级时间戳。

EndTime Long 1608019800000

结束时间戳。毫秒级时间戳。

返回数据

名称 类型 示例值 描述
Code Integer 200

响应状态码。

Data List [{"chainName":"PS-**","code":"9***","blockHeight":"605350","businessId":"129297272256****","totalCount":"2","value":"某公司业务数据。","transactionHash":"ba2fe24cbe23816bdbb18ad037dd5e5f58468cb3ad345e456d106308ed37****","seq":"1","timestamp":"1608005018000"},{"chainName":"PS-**","code":"9***","blockHeight":"605349","businessId":"129297272258****","totalCount":"2","value":"某公司业务数据。","transactionHash":"18440d577e7d77a5d423eee4495902fb29073a904786ee01babc869815c9****","seq":"2","timestamp":"1608003040000"}]

返回Key对应的所有Value数据列表(JSON格式)。

Message String The system is busy. Please try again later.

调用失败时,返回的出错信息。

RequestId String D5C69894-9709-4653-B3D8-25234034C2FC

阿里云为该请求生成的唯一标识符。

Success Boolean true

是否调用成功。

  • true:调用成功。
  • false:调用失败。

示例

请求示例

http(s)://ltl.cn-shanghai.aliyuncs.com/?Action=GetHistoryDataList
&ApiVersion=1.0.0
&CurrentPage=1
&Key=0001_HB5jyvZWzwcM****_0X**_80aa976ac4d64a97bd45c71a509d****
&PageSize=2
&ProductKey=HB5jyvZWzwcM****
&<公共请求参数>

正常返回示例

XML 格式

<GetHistoryDataListResponse>
      <Message></Message>
      <RequestId>D5C69894-9709-4653-B3D8-25234034C2FC</RequestId>
      <Data>
            <Data>[{"chainName":"PS-**","code":"9***","blockHeight":"605350","businessId":"129297272256****","totalCount":"2","value":"某公司业务数据。","transactionHash":"ba2fe24cbe23816bdbb18ad037dd5e5f58468cb3ad345e456d106308ed37****","seq":"1","timestamp":"1608005018000"},{"chainName":"PS-**","code":"9***","blockHeight":"605349","businessId":"129297272258****","totalCount":"2","value":"某公司业务数据。","transactionHash":"18440d577e7d77a5d423eee4495902fb29073a904786ee01babc869815c9****","seq":"2","timestamp":"1608003040000"}]</Data>
      </Data>
      <Code>200</Code>
      <Success>true</Success>
</GetHistoryDataListResponse>

JSON 格式

{
    "Message": "",
    "RequestId": "D5C69894-9709-4653-B3D8-25234034C2FC",
    "Data": {
        "Data": "[{\"chainName\":\"PS-**\",\"code\":\"9***\",\"blockHeight\":\"605350\",\"businessId\":\"129297272256****\",\"totalCount\":\"2\",\"value\":\"某公司业务数据。\",\"transactionHash\":\"ba2fe24cbe23816bdbb18ad037dd5e5f58468cb3ad345e456d106308ed37****\",\"seq\":\"1\",\"timestamp\":\"1608005018000\"},{\"chainName\":\"PS-**\",\"code\":\"9***\",\"blockHeight\":\"605349\",\"businessId\":\"129297272258****\",\"totalCount\":\"2\",\"value\":\"某公司业务数据。\",\"transactionHash\":\"18440d577e7d77a5d423eee4495902fb29073a904786ee01babc869815c9****\",\"seq\":\"2\",\"timestamp\":\"1608003040000\"}]"
    },
    "Code": 200,
    "Success": true
}

错误码

错误码详细信息,请参见错误码