批量转让 NFT

生产环境

https://apis.avata.bianjie.ai

POST

/v1beta1/nft/batch/nft-transfers/{owner}

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

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

注意：在调用此接口时，「AVATA」API 服务平台「允许」应用平台方将 NFT 转让给「任一文昌链合法链账户地址」。

请求参数

Path 参数

owner

string

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

data

array [object {2}]

必需

nfts

array [object {2}]

必需

recipient

string

NFT 接收者地址

必需

<= 128 字符

operation_id

string

必需

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

>= 1 字符<= 64 字符

正则匹配:

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

示例

{
    "data": [
        {
            "nfts": [
                {
                    "class_id": "string",
                    "nft_id": "string"
                }
            ],
            "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/nft-transfers/' \
--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 '{
    "data": [
        {
            "nfts": [
                {
                    "class_id": "string",
                    "nft_id": "string"
                }
            ],
            "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