帮助文档
文档中心
开发者文档
  • AVATA API 文档
  • 底层链 SDK 文档
开发者社区
区块链浏览器
  • 文昌链网浏览器
  • 文昌链极速网
  • 文昌链-天舟
  • 文昌链-神舟
  • 文昌链-天和
关于文昌链
文档中心
开发者文档
  • AVATA API 文档
  • 底层链 SDK 文档
开发者社区
区块链浏览器
  • 文昌链网浏览器
  • 文昌链极速网
  • 文昌链-天舟
  • 文昌链-神舟
  • 文昌链-天和
关于文昌链
AVATA API 文档
  • AVATA API 文档
接入说明AVATA v3 API 文档AVATA v1 API 文档AVATA v2 API 文档
接入说明AVATA v3 API 文档AVATA v1 API 文档AVATA v2 API 文档
  1. Web3域名服务接口
  • API 版本简介
  • 链账户接口
    • 创建链账户
      POST
    • 批量创建链账户
      POST
    • 查询链账户
      GET
    • 查询链账户操作记录
      GET
  • NFT 接口
    • NFT/MT 元数据规范
    • 创建NFT类别
      POST
    • 查询NFT类别
      GET
    • 查询NFT类别详情
      GET
    • 转让NFT类别
      POST
    • 发行 NFT
      POST
    • 转让 NFT
      POST
    • 编辑 NFT
      PATCH
    • 销毁 NFT
      DELETE
    • 查询 NFT
      GET
    • 查询 NFT 详情
      GET
    • 查询 NFT 操作记录
      GET
  • Web3域名服务接口
    • 注册域名
      POST
    • 转让域名
      POST
    • 查询域名
      GET
    • 查询用户域名
      GET
  • 合约服务接口
    • Avata API 合约服务使用说明
    • 调用合约
      POST
    • 查询合约
      GET
  • 购买能量值接口
    • 购买能量值
      POST
    • 批量购买能量值
      POST
    • 查询能量值购买结果
      GET
    • 查询能量值购买结果列表
      GET
  • 钱包服务接口
    • 创建钱包用户
    • 更新钱包用户
    • 认证钱包用户
    • 查询钱包用户信息
  • 查询交易结果接口
    • 查询上链交易结果
  1. Web3域名服务接口

注册域名

生产环境
https://apis.avata.bianjie.ai
生产环境
https://apis.avata.bianjie.ai
POST
https://apis.avata.bianjie.ai
/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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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

扫码加入文昌链微信技术交流群

在这里,获得 Avata 使用上的任何帮助,快速上手让你的研测效率大幅提升

扫码添加小助手
修改于 2023-10-26 03:21:37
上一页
查询 NFT 操作记录
下一页
转让域名
Built with