5.4.3.8 获取交易信息接口
链下系统使用该接口可以根据交易ID获取交易信息。
1. 接口地址: https://节点网关地址/api/fabric/v1/node/getTransaction
2. 通讯方式:POST
3. 签名算法:详见5.4.3.1应用接入签名算法
4. 请求参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 用户唯一标示 | userCode | String | 是 | |
2 | 应用唯一标识 | appCode | String | 是 | |
body: | |||||
1 | 交易Id | txId | String | 是 |
示例:
{
"header":{
"userCode":"USER0001202004151958010871292",
"appCode":"app0001202004161020152918451",
"tId":""
},
"mac":"MEUCIQDIbcNl+C1iBbXWGW3qjhf80IRgCgvJuyxx0WXU2vn2TAIgZgA020L2aXBtrdLsYEkYPyiOJ9+AFrXOEwfuzy8B4bE=",
"body":{
"txId":"c3c6523958c3811192b8d358dd2617f1b14cb661de6b022c1a822269e8a8c48d"
}
}
5. 响应参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 响应标识 | code | int | 是 | 0:校验成功 -1:校验失败 |
2 | 响应信息 | msg | String | 否 | code=0时可为null |
body: | |||||
1 | 块Hash | blockHash | String | 是 | |
2 | 块号 | blockNumber | Long | 是 | |
3 | 交易状态 | status | Int | 是 | [详见交易状态描述] |
4 | 上链用户名 | createName | String | 是 | |
5 | 时间戳秒 | timeSpanSec | Int64 | 是 | 时间戳的秒部分 |
6 | 时间戳纳秒 | timeSpanNsec | Int64 | 是 | 时间戳的纳秒部分 |
示例:
{
"header": {
"code": 0,
"msg": "处理成功"
},
"mac": "MEUCIQDUFw5pa4QJcEiQjYeLTl2L94HbsZbz7DArF+djgzWoTQIgU8u+dG6CcHwBZjuf9PvhYdEFAa/ujwo8UAPbAmKxRq0=",
"body": {
"blockHash": "ab9366cf63881228863c884527fceefabc9ad2e375aa0bcbf71f17f75c7d3ff5",
"blockNumber": 7,
"status": 0,
"createName": "test02@app0001202004161020152918451",
"timeSpanSec": 1587445821,
"timeSpanNsec": 249139700
}
}