数据查询,该API用于从LTL查询上传数据的区块链元信息。

可访问账号:

业务管理方

业务使用方

请求参数

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

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

ApiVersion String 1.0.0

API版本号,"1.0.0"。

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

数据Key唯一标识。

ProductKey String HB5jyvZWzwcM****

业务链编码。

BusinessId String 000000000000000000000000000000000000000000000000000000000001****

1. 用户业务ID,同一个Key,业务ID必须唯一。格式为64字符,合法字符范围[0-9,a-f,A-F]。

2. 如果不包含该参数,则返回当前Key最新数据。

返回数据

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

响应状态码。

Success Boolean true

是否调用成功。

  • true:调用成功。
  • false:调用失败。
Message String The system is busy. Please try again later.

错误消息。

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

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

Data String {"blockChainInfo":{"chainName":"某公司业务链","blockHeight":48971,"transactionHash":"ea8752787f79be085d9ee244a1b9ed0deb198903a14b9b1a6800b20fbf0d****","iotId":"1BE0F46275B17147E7D2****","endorsementNames":"某公司,某某公司","timestamp":"1591676312000","blockHash":"d07bdaf2736c4d07bdaf2736e5faae508d77ceb82c0e9722a8bcca0e909e****","previousHash":"c4d07bdaf2736cc0ec0e909e60e5c21dc14d0eb823eb82f4f99791c4d07b****","dataHash":"21dc1288bcc0e2730ae486fa04fdeb828ae5c21dc128c525a655972e5faa****"}}

返回唯一标识key对应的区块链元数据信息(JSON格式)。详情请参见下表blockChainInfo。

blockChainInfo

参数

类型

示例值

描述

chainName

String

某公司业务链

存储区块链名称。

blockHeight

Long

48971

区块链存证区块号。

transactionHash

String

ea8752787f79be085d9ee244a1b9ed0deb198903a14b9b1a6800b20f********

交易哈希。

iotId

String

1BE0F46275B17147E7D2****

IoT设备ID。

endorsementNames

String

某公司,某某公司

区块链背书节点名称。

timestamp

String

1591676312000

存证时间。毫秒级时间戳。

blockHash

String

d07bdaf2736c4d07bdaf2736e5faae508d77ceb82c0e9722a8bcca0e********

区块哈希。

previousHash

String

c4d07bdaf2736cc0ec0e909e60e5c21dc14d0eb823eb82f4f99791c4********

上一区块哈希。

dataHash

String

21dc1288bcc0e2730ae486fa04fdeb828ae5c21dc128c525a655972e********

数据哈希。

示例

请求示例

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

正常返回示例

XML 格式

<GetBlockChainInfoResponse>
      <Message></Message>
      <RequestId>D5C69894-9709-4653-B3D8-25234034C2FC</RequestId>
      <Data>{"blockChainInfo":{"chainName":"某公司业务链","blockHeight":48971,"transactionHash":"ea8752787f79be085d9ee244a1b9ed0deb198903a14b9b1a6800b20fbf0d****","iotId":"1BE0F46275B17147E7D2****","endorsementNames":"某公司,某某公司","timestamp":"1591676312000","blockHash":"d07bdaf2736c4d07bdaf2736e5faae508d77ceb82c0e9722a8bcca0e909e****","previousHash":"c4d07bdaf2736cc0ec0e909e60e5c21dc14d0eb823eb82f4f99791c4d07b****","dataHash":"21dc1288bcc0e2730ae486fa04fdeb828ae5c21dc128c525a655972e5faa****"}}</Data>
      <Code>200</Code>
      <Success>true</Success>
</GetBlockChainInfoResponse>

JSON 格式

{
    "Message": "",
    "RequestId": "D5C69894-9709-4653-B3D8-25234034C2FC",
    "Data": "{\"blockChainInfo\":{\"chainName\":\"某公司业务链\",\"blockHeight\":48971,\"transactionHash\":\"ea8752787f79be085d9ee244a1b9ed0deb198903a14b9b1a6800b20fbf0d****\",\"iotId\":\"1BE0F46275B17147E7D2****\",\"endorsementNames\":\"某公司,某某公司\",\"timestamp\":\"1591676312000\",\"blockHash\":\"d07bdaf2736c4d07bdaf2736e5faae508d77ceb82c0e9722a8bcca0e909e****\",\"previousHash\":\"c4d07bdaf2736cc0ec0e909e60e5c21dc14d0eb823eb82f4f99791c4d07b****\",\"dataHash\":\"21dc1288bcc0e2730ae486fa04fdeb828ae5c21dc128c525a655972e5faa****\"}}",
    "Code": 200,
    "Success": true
}

错误码

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