查询 MT 操作记录

生产环境

https://apis.avata.bianjie.ai

GET

/v1beta1/mt/mts/{class_id}/{mt_id}/history

AVATA API 文档/AVATA API 文档/AVATA v1 API 文档/MT 接口

根据查询条件，展示与应用相关的 MT 链上操作记录

请求参数

Path 参数

class_id

string

MT 类别 ID

必需

mt_id

string

MT ID

必需

Query 参数

offset

string

游标，默认为 0

可选

limit

string

可选

每页记录数，默认为 10，上限为 50

signer

string

Tx 签名者地址

可选

tx_hash

string

可选

MT 操作 Tx Hash

operation

string

可选

操作类型： issue(首发MT) / mint(增发MT) / edit(编辑MT) / transfer(转让MT) / burn(销毁MT)

start_date

string

可选

MT 操作日期范围 - 开始，yyyy-MM-dd（UTC 时间）

end_date

string

可选

MT 操作日期范围 - 结束，yyyy-MM-dd（UTC 时间）

sort_by

string

可选

排序规则：DATE_ASC / DATE_DESC(默认)

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

curl --location --request GET 'https://apis.avata.bianjie.ai/v1beta1/mt/mts///history?offset=&limit=&signer=&tx_hash=&operation=&start_date=&end_date=&sort_by=' \
--header 'X-Api-Key;' \
--header 'X-Api-Key;' \
--header 'X-Timestamp;' \
--header 'X-Timestamp;' \
--header 'X-Signature;' \
--header 'X-Signature;'

返回响应

🟢200successful operation

application/json

Body

data

object

正确返回值

可选

offset

integer

游标

必需

limit

integer

每页记录数

必需

total_count

integer

总记录数

必需

operation_records

array[object (empty object) {6}]

操作记录列表

必需

示例

{
  "data": {
    "offset": 0,
    "limit": 0,
    "total_count": 0,
    "operation_records": [
      {
        "tx_hash": "string",
        "operation": "issue",
        "signer": "string",
        "recipient": "string",
        "amount": 0,
        "timestamp": "string"
      }
    ]
  }
}

🟠400failed operation

查询 MT

查询 MT 余额