创建 NFT 类别

生产环境

POST

/v1beta1/nft/classes

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

NFT 类别是 IRITA 底层链对同一资产类型的识别和集合，方便资产发行方对链上资产进行管理和查询。所以在发行 NFT 前，都需要创建 NFT 类别，用以声明其抽象属性。

请求参数

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)

Body 参数application/json

name

string

NFT 类别名称

必需

>= 1 字符<= 20 字符

class_id

string

可选

NFT 类别 ID，仅支持小写字母及数字，以字母开头

>= 3 字符<= 32 字符

symbol

string

标识

可选

>= 3 字符<= 32 字符

description

string

描述

可选

<= 300 字符

uri

string <uri>

链外数据链接

可选

<= 256 字符

uri_hash

string

链外数据 Hash

可选

<= 512 字符

data

string

自定义链上元数据

可选

<= 1024 字符

owner

string

必需

NFT 类别权属者地址，拥有在该 NFT 类别中发行 NFT 的权限和转让该 NFT 类别的权限。

支持任一 AVATA 平台内合法链账户地址

<= 128 字符

operation_id

string

必需

操作 ID，保证幂等性，避免重复请求，保证对于同一操作发起的一次请求或者多次请求的结果是一致的；由接入方生成的、针对每个 Project ID 唯一的、不超过 64 个大小写字母、数字、-、下划线的字符串

>= 1 字符<= 64 字符

正则匹配:

^[a-zA-Z0-9_-]+$

示例

{
  "name": "string",
  "class_id": "string",
  "symbol": "string",
  "description": "string",
  "uri": "http://example.com",
  "uri_hash": "string",
  "data": "string",
  "owner": "string",
  "operation_id": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://apis.avata.bianjie.ai/v1beta1/nft/classes' \
--header 'X-Api-Key;' \
--header 'X-Api-Key;' \
--header 'X-Timestamp;' \
--header 'X-Timestamp;' \
--header 'X-Signature;' \
--header 'X-Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "class_id": "string",
    "symbol": "string",
    "description": "string",
    "uri": "http://example.com",
    "uri_hash": "string",
    "data": "string",
    "owner": "string",
    "operation_id": "string"
}'

返回响应

🟢200successful operation

application/json

Body

data

object

正确返回值

必需

operation_id

string

操作 ID

必需

<= 64 字符

示例

{
  "data": {
    "operation_id": "string"
  }
}

🟠400failed operation

修改于 2023-10-26 03:04:30

查询链账户操作记录

查询 NFT 类别详情