查询上链交易结果

根据在接口请求时自定义的 Operation ID ，查询相关的链上操作结果。每笔交易会产生唯一的 Operation ID，根据 Operation ID，可以查询具体的交易结果，包含交易状态、交易信息及交易详情。

当前支持查询当月及上个月的交易结果，其它月历史数据已归档，暂不支持查询对应结果。

注意：若查询出的链上操作结果 status 为 2（失败），请在业务侧做容错处理。可以参考接口返回的 message（交易失败的错误描述信息）对接口的请求参数做适当调整后，使用「新的 Operation ID 」重新发起接口请求。

请求参数

Path 参数

operation_id

string

必需

操作 ID，是指用户在进行具体的NFT/MT/业务接口请求时，自定义的操作ID。注意：如果是创建链账户/批量创建链账户的操作 ID，不可通过此接口查询上链交易结果，须前往查询链账户接口进行查询。

Header 参数

Content-Type

string

必需

固定值：application/json

X-Api-Key

string

必需

项目 API Key，用于 API 访问鉴权

X-Timestamp

string

必需

时间戳，1970年1月1日0点0分0秒到现在的毫秒数

X-Signature

string

必需

API 签名，算法为SHA256(Params+Timestamp+ApiSecret)

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200successful operation

application/json

Body

data

object

必需

module

integer

必需

交易模块：请通过查询枚举值列表接口查看

operation

integer

必需

用户操作类型请通过查询枚举值列表接口查看

tx_hash

string

交易哈希

可选

status

integer

必需

交易状态， 0 处理中； 1 成功； 2 失败； 3 未处理；

交易状态说明：

status 为 3（未处理），上链请求还在等待处理，请稍等；

status 为 0（处理中），上链请求正在处理，请等待处理完成；

status 为 1（成功），交易已上链并执行成功；

当交易状态：2 失败，可以参考接口返回的 message（交易失败的错误描述信息）对请求参数做适当调整后，使用「新的 Operation ID 」重新发起交易请求。

message

string

可选

交易失败的错误描述信息

block_height

integer

交易上链的区块高度

可选

timestamp

string

可选

交易上链时间（UTC 时间）

nft

object

可选

对应不同操作类型的消息体,下方的 Key 只作为展示用, 实际返回中不存在该 Key, 只返回对应数据

object

可选

对应不同操作类型的消息体,下方的 Key 只作为展示用, 实际返回中不存在该 Key, 只返回对应数据

示例

{
    "data": {
        "module": 0,
        "operation": 0,
        "tx_hash": "string",
        "status": 0,
        "message": "string",
        "block_height": 0,
        "timestamp": "string",
        "nft": {
            "issue_class": {
                "class_id": "string"
            },
            "transfer_class": {
                "class_id": "string"
            },
            "mint": {
                "class_id": "string",
                "id": 0
            },
            "edit": {
                "class_id": "string",
                "id": 0
            },
            "transfer": {
                "class_id": "string",
                "id": 0
            },
            "burn": {
                "class_id": "string",
                "id": 0
            }
        },
        "ns": {
            "create_domain": {
                "name": "string",
                "owner": "string",
                "node": "string",
                "expires": 0
            },
            "transfer_domain": {
                "name": "string",
                "owner": "string",
                "node": "string",
                "expires": 0
            },
            "resolve": {
                "addr": {
                    "block_chain": 0,
                    "addr_value": "string"
                },
                "text": {
                    "key": "string",
                    "text_value": "string"
                }
            },
            "reverse_resolve": {
                "addr": "string",
                "name": "string"
            }
        }
    }
}

🟠400failed operation