帮助文档
文档中心
开发者文档
  • AVATA API 文档
  • 底层链 SDK 文档
开发者社区
区块链浏览器
  • 文昌链网浏览器
  • 文昌链极速网
  • 文昌链-天舟
  • 文昌链-神舟
  • 文昌链-天和
关于文昌链
文档中心
开发者文档
  • AVATA API 文档
  • 底层链 SDK 文档
开发者社区
区块链浏览器
  • 文昌链网浏览器
  • 文昌链极速网
  • 文昌链-天舟
  • 文昌链-神舟
  • 文昌链-天和
关于文昌链
AVATA API 文档
  • AVATA API 文档
接入说明AVATA v3 API 文档AVATA v1 API 文档AVATA v2 API 文档
接入说明AVATA v3 API 文档AVATA v1 API 文档AVATA v2 API 文档
  1. NFT 接口
  • API 版本简介
  • 链账户接口
    • 创建链账户
      POST
    • 批量创建链账户
      POST
    • 查询链账户
      GET
  • 原生模块
    • 关于原生模块
    • NFT 接口
      • 创建 NFT 类别
      • 查询 NFT 类别
      • 查询 NFT 类别详情
      • 转让 NFT 类别
      • 发行 NFT
      • 转让 NFT
      • 编辑 NFT
      • 销毁 NFT
      • 查询 NFT
      • 查询 NFT 详情
      • 查询 NFT 操作记录
    • MT 接口
      • 创建 MT 类别
      • 查询 MT 类别
      • 查询 MT 类别详情
      • 转让 MT 类别
      • 发行 MT
      • 增发 MT
      • 转让 MT
      • 编辑 MT
      • 销毁 MT
      • 查询 MT
      • 查询 MT 详情
      • 查询 MT 操作记录
      • 查询 MT 余额
    • 区块链存证接口
      • 数字作品存证接口
    • 查询上链交易结果
      GET
    • 查询链账户操作记录
      GET
    • 查询枚举值列表
      GET
  • 智能合约模块
    • 关于智能合约模块
    • NFT 接口
      • 创建 NFT 类别
        POST
      • 查询 NFT 类别
        GET
      • 查询 NFT 类别详情
        GET
      • 转让 NFT 类别
        POST
      • 发行 NFT
        POST
      • 转让 NFT
        POST
      • 销毁 NFT
        DELETE
      • 编辑 NFT
        PATCH
      • 查询 NFT
        GET
      • 查询 NFT 详情
        GET
      • 查询 NFT 操作记录
        GET
    • Web3 域名服务接口
      • 注册域名
      • 转让域名
      • 续购域名
      • 查询域名
      • 查询用户域名
      • 设置域名解析
      • 查询域名解析
      • 设置域名反向解析
      • 查询域名反向解析
    • 合约服务接口
      • Avata API 合约服务使用说明
      • 调用合约
      • 查询合约
    • 查询上链交易结果
      GET
    • 查询链账户操作记录
      GET
    • 查询枚举值列表
      GET
  • 购买能量值接口
    • 购买能量值
    • 批量购买能量值
    • 查询能量值购买结果
    • 查询能量值购买结果列表
  • 钱包服务接口
    • 创建钱包用户
    • 更新钱包用户
    • 认证钱包用户
    • 查询钱包用户信息
  1. NFT 接口

创建 NFT 类别

生产环境
生产环境
POST
https://apis.avata.bianjie.ai
/v3/evm/nft/classes
AVATA API 文档/AVATA API 文档/AVATA v3 API 文档/智能合约模块/NFT 接口
NFT 类别是底层区块链对同一属性或类型资产的识别和集合,方便资产发行方对链上资产进行管理和查询,所以在发行 NFT 前,需要先创建 NFT 类别,用以声明其抽象属性。
在 AVATA v3 evm 版本中,每一个 NFT 类别相当于一个链上智能合约(class_id 相当于智能合约地址),由 Avata 平台根据接口请求参数自动执行链上合约部署,无需应用方关心复杂的智能合约编写及部署逻辑。

请求参数

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 字符
uri
string 
链外资源标识符
可选
指该 NFT 类别在链外的元数据存储地址或其他链外资源的标识
元数据规范建议参考:https://forum.avata.bianjie.ai/t/topic/81
<= 256 字符
symbol
string 
标识
必需
NFT 类别标识,用于快速识别和查询该类 NFT 资产
>= 3 字符<= 32 字符
owner
string 
NFT 类别权属者
必需
NFT 类别权属者地址,拥有在该 NFT 类别中发行 NFT 的权限。 支持任一 Avata 平台内合法链账户地址(Hex 格式)
<= 128 字符
editable_by_owner
enum<integer> 
权限控制
可选
NFT 类别权限的控制功能, 此类别下某一 NFT 的持有者可以编辑该 NFT
1 可编辑
0 不可编辑
枚举值:
10
默认值:
1
editable_by_class_owner
enum<integer> 
权限控制
可选
NFT 类别权限的控制功能, 此 NFT 类别的权属者可以编辑这个类别下所有的 NFT
1 可编辑
0 不可编辑
枚举值:
10
默认值:
0
operation_id
string 
操作ID
必需
保证幂等性,避免重复请求,保证对于同一操作发起的一次请求或者多次请求的结果是一致的;由接入方生成并自行维护、针对每个 Project ID 唯一的、不超过 64 个大小写字母、数字、-、下划线的字符串
>= 1 字符<= 64 字符
正则匹配:
^[a-zA-Z0-9_-]+$
示例
{
  "name": "string",
  "uri": "string",
  "uri_hash": "string",
  "symbol": "string",
  "owner": "string",
  "editable_by_owner": 0,
  "editable_by_class_owner": 0,
  "operation_id": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://apis.avata.bianjie.ai/v3/evm/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",
    "uri": "string",
    "uri_hash": "string",
    "symbol": "string",
    "owner": "string",
    "editable_by_owner": 0,
    "editable_by_class_owner": 0,
    "operation_id": "string"
}'

返回响应

🟢200successful operation
application/json
Body
data
object 
正确返回值
必需
示例
{
  "data": {}
}
🟠400failed operation

扫码加入文昌链微信技术交流群

在这里,获得 Avata 使用上的任何帮助,快速上手让你的研测效率大幅提升

扫码添加小助手
修改于 2023-10-26 02:52:54
上一页
关于智能合约模块
下一页
查询 NFT 类别
Built with