数据查询,该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 |
是否调用成功。
|
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。 |
参数 |
类型 |
示例值 |
描述 |
---|---|---|---|
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
}
错误码
错误码详细信息,请参见错误码。