查询上链交易结果

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 / 业务接口请求。

请求参数

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)

示例代码

返回响应

successful operation(200)

successful operation

HTTP 状态码: 200

内容格式: JSONapplication/json

data

object

正确返回值

可选

type

enum<string>

用户操作类型

必需

<= 16 字符

枚举值:

issue_classtransfer_classmint_nftedit_nftburn_nfttransfer_nftissue_class_mttransfer_class_mtissue_mtmint_mtedit_mtburn_mttransfer_mtmint_nft_batchedit_nft_batchburn_nft_batchtransfer_nft_batchcreate_record

module

enum<string>

交易模块

必需

枚举值:

nftmtrecord

tx_hash

string

交易哈希

可选

<= 128 字符

status

enum<integer>

必需

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

交易状态说明：

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

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

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

status 为 2（失败），说明该交易执行失败。请在业务侧做容错处理。可以参考接口返回的 message（交易失败的错误描述信息）对 NFT / MT / 业务接口的请求参数做适当调整后，使用「新的 Operation ID 」重新发起 NFT / MT / 业务接口请求。

枚举值:

0123

message

string

可选

交易失败的错误描述信息

<= 512 字符

block_height

number

交易上链的区块高度

可选

timestamp

string

可选

交易上链时间（UTC 时间）

nft

object

可选

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

object

可选

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

record

object

可选

对应不同操作类型的消息体,下方的 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"
      }
    }
  }
}

最后修改时间： 1 年前