编辑 NFT

生产环境

https://apis.avata.bianjie.ai

PATCH

/v3/native/nft/nfts/{class_id}/{owner}/{nft_id}

AVATA API 文档/AVATA API 文档/AVATA v3 API 文档/原生模块/NFT 接口

对于已经发布至链上的 NFT ，可根据需求来编辑链上 NFT 的相关信息，如名称、元数据等信息。
注意：只可编辑自己链账户所拥有的 NFT 信息，对于由自己发行，但已经归属于其它链账户地址的 NFT，不可进行编辑。

请求参数

Path 参数

class_id

string

NFT 类别 ID

必需

owner

string

必需

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

nft_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 名称（该值若不填，则以空值上链）

<= 64 字符

uri

string

可选

链外数据链接（该值若不填，则以空值上链）

<= 256 字符

data

string

可选

自定义链上元数据（该值若不填，则以空值上链）

<= 1024 字符

uri_hash

string

可选

链外数据 Hash （该值若不填，则以空值上链）

<= 512 字符

operation_id

string

必需

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

>= 1 字符<= 64 字符

示例

{
    "name": "string",
    "uri": "string",
    "data": "string",
    "uri_hash": "string",
    "operation_id": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://apis.avata.bianjie.ai/v3/native/nft/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",
    "data": "string",
    "uri_hash": "string",
    "operation_id": "string"
}'

返回响应

🟢200successful operation

application/json

Body

data

object

正确返回值

可选

示例

{
    "data": {}
}

🟠400failed operation

转让 NFT

销毁 NFT