注册域名

生产环境

https://apis.avata.bianjie.ai

POST

/v2/ns/domains

AVATA API 文档/AVATA API 文档/AVATA v2 API 文档/web3域名服务接口

文昌链域名服务（Wenchang Name Service，简称 WNS）是一个基于 EVM 智能合约的分布式、开放和可扩展的命名系统。
WNS 的工作是将可读的名称（如 “avata.w”）解析为计算机可以识别的标识符，如文昌链地址、其他底层区块链地址、内容的哈希、元数据、文本内容等。WNS 还支持 “反向解析”，这使得将元数据(如规范化名称或接口描述)与底层区块链地址相关联成为可能。

文昌链目前可注册的一级根域名有：【.w】、【.dao】、【.meta】、【.id】、【.wallet】

请求参数

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

域名

必需

包含大小写英文字母、阿拉伯数字和连字符 -；不区分大小写；长度不包括后缀
文昌链目前可注册的一级根域名有：【.w】、【.dao】、【.meta】、【.id】、【.wallet】

>= 4 字符<= 64 字符

owner

string

域名拥有者的链账户地址

必需

任一 AVATA 内托管的地址

duration

integer

购买年限

必需

枚举：1,2,3,4,5

operation_id

string

操作 ID

必需

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

示例

{
    "name": "string",
    "owner": "string",
    "duration": 0,
    "operation_id": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://apis.avata.bianjie.ai/v2/ns/domains' \
--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",
    "owner": "string",
    "duration": 0,
    "operation_id": "string"
}'

返回响应

🟢200successful operation

application/json

Body

data

object

必需

示例

{
    "data": {}
}

🟠400failed operation

修改于 2023-10-26 03:21:37

查询 NFT 操作记录

转让域名