批量销毁 NFT

生产环境

https://apis.avata.bianjie.ai

DELETE

/v1beta1/nft/batch/nfts/{owner}

NFT 的拥有者可以调用该接口批量销毁其 NFT，批量销毁的 NFT 数量上限为 10。使用批量销毁 NFT 接口时，需保证此交易体小于 7000 字节，如果交易体数据很难估算准确，建议避免使用批量发行方法。由于批量发行方法对网络平滑出块影响比较大，后续其 GAS 费有可能被调高以不鼓励批量发行方法的使用。

注意：NFT 销毁后，链上依然会保留与该 NFT 相关的链上历史记录信息，但不可再对该 NFT 进行任何的操作。

请求参数

Path 参数

owner

string

必需

NFT 持有者地址，也是 Tx 签名者地址

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

nfts

array [object {2}]

必需

class_id

string

NFT 类别 ID

必需

nft_id

string

NFT ID

必需

operation_id

string

必需

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

>= 1 字符<= 64 字符

正则匹配:

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

示例

{
    "nfts": [
        {
            "class_id": "string",
            "nft_id": "string"
        }
    ],
    "operation_id": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE '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 '{
    "nfts": [
        {
            "class_id": "string",
            "nft_id": "string"
        }
    ],
    "operation_id": "string"
}'

返回响应

🟢200successful operation

application/json

Body

data

object

正确返回值

可选

operation_id

string

操作 ID

必需

<= 64 字符

示例

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

🟠400failed operation

修改于 2023-08-22 02:07:46

批量编辑 NFT

查询 NFT