批量发行 NFT

生产环境

https://apis.avata.bianjie.ai

POST

/v1beta1/nft/batch/nfts/{class_id}

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

NFT 是链上唯一的、可识别的资产，由用户自己在区块链上批量铸造 NFT，单次请求批量发行数量上限10。使用批量发行 NFT 接口时，需保证此交易体小于 7000 字节，如果交易体数据很难估算准确，建议避免使用批量发行方法。由于批量发行方法对网络平滑出块影响比较大，后续其 GAS 费有可能被调高以不鼓励批量发行方法的使用。

请求参数

Path 参数

class_id

string

NFT 类别 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)

Body 参数application/json

name

string

NFT 名称

必需

>= 1 字符<= 64 字符

uri

string

链外数据链接

可选

<= 256 字符

uri_hash

string

链外数据 Hash

可选

<= 512 字符

data

string

自定义链上元数据

可选

<= 1024 字符

recipients

array[object (empty object) {2}]

必需

NFT 接收者地址和发行数量。以数组的方式进行组合，可以自定义多个组合，可面向多地址批量发行 NFT。

amount

integer

NFT 发行数量

必需

recipient

string

必需

NFT 接收者地址，支持任一文昌链合法链账户地址。

operation_id

string

必需

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

>= 1 字符<= 64 字符

正则匹配:

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

示例

{
  "name": "string",
  "uri": "string",
  "uri_hash": "string",
  "data": "string",
  "recipients": [
    {
      "amount": 0,
      "recipient": "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/batch/nfts/' \
--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",
    "data": "string",
    "recipients": [
        {
            "amount": 0,
            "recipient": "string"
        }
    ],
    "operation_id": "string"
}'

返回响应

🟢200successful operation

application/json

Body

data

object

正确返回值

可选

operation_id

string

操作 ID

必需

<= 64 字符

示例

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

🟠400failed operation

销毁 NFT

批量转让 NFT