查询上链交易结果
GET
/v1beta1/tx/{operation_id}根据在接口请求时自定义的 Operation ID ,查询相关的链上操作结果。每笔交易会产生唯一的 Operation ID,根据 Operation ID,可以查询具体的交易结果,包含交易状态、交易信息及交易详情。 Operation ID 的值为原 Task ID 对应的值,建议程序中尽早将 Task ID 替换为 Operation ID。
当前支持查询当月及上个月的交易结果,其它月历史数据已归档,暂不支持查询对应结果。
注意:
若查询出的链上操作结果 status 为 2(失败),请在业务侧做容错处理。可以参考接口返回的 message(交易失败的错误描述信息) 对 NFT / MT / 业务接口的请求参数做适当调整后,使用「新的 Operation ID 」 重新发起 NFT / MT / 业务接口请求。
请求参数
操作 ID,是指用户在进行具体的NFT/MT/业务接口请求时,自定义的操作ID。注意:如果是创建链账户/批量创建链账户的操作 ID,不可通过此接口查询上链交易结果,须前往查询链账户接口进行查询。
返回响应
交易状态, 0 处理中; 1 成功; 2 失败; 3 未处理;
交易状态说明:
status 为 3(未处理),上链请求还在等待处理,请稍等;
status 为 0(处理中),上链请求正在处理,请等待处理完成;
status 为 1(成功),交易已上链并执行成功;
status 为 2(失败),说明该交易执行失败。请在业务侧做容错处理。可以参考接口返回的 message(交易失败的错误描述信息) 对 NFT / MT / 业务接口的请求参数做适当调整后,使用「新的 Operation ID 」重新发起 NFT / MT / 业务接口请求。
交易失败的错误描述信息
交易上链时间(UTC 时间)
对应不同操作类型的消息体,下方的 Key 只作为展示用, 实际返回中不存在该 Key, 只返回对应数据
对应不同操作类型的消息体,下方的 Key 只作为展示用, 实际返回中不存在该 Key, 只返回对应数据
对应不同操作类型的消息体,下方的 Key 只作为展示用, 实际返回中不存在该 Key, 只返回对应数据
{
"data": {
"type": "issue_class",
"module": "nft",
"tx_hash": "string",
"status": 0,
"message": "string",
"block_height": 0,
"timestamp": "string",
"nft": {
"issue_class": {
"class_id": "string",
"nft_id": "string"
},
"transfer_class": {
"class_id": "string",
"nft_id": "string"
},
"mint": {
"class_id": "string",
"nft_id": "string"
},
"edit": {
"class_id": "string",
"nft_id": "string"
},
"transfer": {
"class_id": "string",
"nft_id": "string"
},
"burn": {
"class_id": "string",
"nft_id": "string"
},
"mint_nft_batch": {
"class_id": "string",
"nft_id": "string"
},
"edit_nft_batch": {
"class_id": "string",
"nft_id": "string"
},
"transfer_nft_batch": {
"class_id": "string",
"nft_id": "string"
},
"burn_nft_batch": {
"class_id": "string",
"nft_id": "string"
}
},
"mt": {
"issue_class": {
"class_id": "string",
"mt_id": "string"
},
"transfer_class": {
"class_id": "string",
"mt_id": "string"
},
"issue": {
"class_id": "string",
"mt_id": "string"
},
"mint": {
"class_id": "string",
"mt_id": "string"
},
"edit": {
"class_id": "string",
"mt_id": "string"
},
"transfer": {
"class_id": "string",
"mt_id": "string"
},
"burn": {
"class_id": "string",
"mt_id": "string"
}
},
"record": {
"create_record": {
"record_id": "string",
"certificate_url": "string"
}
}
}
}