Avata 帮助文档-测试
  1. Web3 域名服务接口
Avata 帮助文档-测试
  • Avata 平台文档
    • 平台介绍
      • 平台简介
      • 核心功能
      • 基础术语
      • 平台服务
        • 文昌链极速网
        • 文昌链存证服务
        • 文昌链域名服务
        • 第三方支付服务
    • 用户指南
      • 接入流程
      • AVATA API 接入说明
      • AVATA API 最佳实践
      • 费用说明
    • 常见问题
      • AVATA 平台 NFT 元数据规范
      • Avata 测试项目如何充值能量值
      • Avata 技术社区使用指南
      • 原生 NFT 和原生 MT 区别
      • operation_id 的作用
      • AVATA API & 底层链 SDK 如何选择
      • 如何开具发票
      • 申请平台合作协议
      • 网信办备案填报指南
      • 变更认证主体流程说明
      • 更多问题 >>
  • AVATA API 文档
    • AVATA API 文档
      • 接入说明
        • 网关鉴权签名示例
        • 交易结果异步回调通知
      • AVATA v3 API 文档
        • API 版本简介
        • 链账户接口
          • 创建链账户
          • 批量创建链账户
          • 查询链账户
        • 原生模块
          • 关于原生模块
          • NFT 接口
            • 创建 NFT 类别
            • 转让 NFT 类别
            • 查询 NFT 类别
            • 查询 NFT 类别详情
            • 发行 NFT
            • 转让 NFT
            • 编辑 NFT
            • 销毁 NFT
            • 查询 NFT
            • 查询 NFT 详情
            • 查询 NFT 操作记录
          • MT 接口
            • 创建 MT 类别
            • 查询 MT 类别
            • 查询 MT 类别详情
            • 转让 MT 类别
            • 发行 MT
            • 增发 MT
            • 转让 MT
            • 编辑 MT
            • 销毁 MT
            • 查询 MT
            • 查询 MT 详情
            • 查询 MT 操作记录
            • 查询 MT 余额
          • 区块链存证接口
            • 数字作品存证接口
          • 查询链账户操作记录
          • 查询上链交易结果
          • 查询枚举值列表
        • 智能合约模块
          • 关于智能合约模块
          • NFT 接口
            • 创建 NFT 类别
            • 转让 NFT 类别
            • 查询 NFT 类别
            • 查询 NFT 类别详情
            • 发行 NFT
            • 转让 NFT
            • 编辑 NFT
            • 销毁 NFT
            • 查询 NFT
            • 查询 NFT 详情
            • 查询 NFT 操作记录
          • 合约服务接口
            • Avata API 合约服务使用说明
            • 调用合约
            • 查询合约
          • Web3 域名服务接口
            • 注册域名
              POST
            • 转让域名
              POST
            • 查询域名
              GET
            • 查询用户域名
              GET
            • 设置域名解析
              POST
            • 查询域名解析
              GET
            • 设置域名反向解析
              POST
            • 查询域名反向解析
              GET
            • 续购域名
              POST
          • 查询链账户操作记录
            GET
          • 查询上链交易结果
            GET
          • 查询枚举值列表
            GET
        • 购买能量值接口
          • 购买能量值
          • 批量购买能量值
          • 查询能量值购买结果
          • 查询能量值购买结果列表
        • 钱包服务接口
          • 创建钱包用户
          • 更新钱包用户
          • 查询钱包用户信息
          • 认证钱包用户
      • AVATA v2 API 文档
        • API 版本简介
        • 链账户接口
          • 创建链账户
          • 批量创建链账户
          • 查询链账户
          • 查询链账户操作记录
        • NFT 接口
          • NFT/MT 元数据规范
          • 创建NFT类别
          • 查询NFT类别
          • 查询NFT类别详情
          • 转让NFT类别
          • 发行 NFT
          • 转让 NFT
          • 编辑 NFT
          • 销毁 NFT
          • 查询 NFT
          • 查询 NFT 详情
          • 查询 NFT 操作记录
        • web3域名服务接口
          • 注册域名
          • 转让域名
          • 查询域名
          • 查询用户域名
        • 合约服务接口
          • Avata API 合约服务使用说明
          • 调用合约
          • 查询合约
        • 购买能量值接口
          • 购买能量值
          • 批量购买能量值
          • 查询能量值购买结果
          • 查询能量值购买结果列表
        • 区块链存证接口
          • 数字作品存证接口
        • 钱包服务接口
          • 创建钱包用户
          • 更新钱包用户
          • 查询钱包用户信息
          • 认证钱包用户
        • 查询交易结果接口
          • 查询上链交易结果
      • AVATA v1 API 文档
        • API 版本简介
        • 链账户接口
          • 创建链账户
          • 批量创建链账户
          • 查询链账户
          • 查询链账户操作记录
        • NFT 接口
          • 创建 NFT 类别
          • 查询 NFT 类别
          • 查询 NFT 类别详情
          • 转让 NFT 类别
          • 发行 NFT
          • 转让 NFT
          • 编辑 NFT
          • 销毁 NFT
          • 批量发行 NFT
          • 批量转让 NFT
          • 批量编辑 NFT
          • 批量销毁 NFT
          • 查询 NFT
          • 查询 NFT 详情
          • 查询 NFT 操作记录
        • MT 接口
          • 创建 MT 类别
          • 查询 MT 类别
          • 查询 MT 类别详情
          • 转让 MT 类别
          • 增发 MT
          • 发行 MT
          • 转让 MT
          • 编辑 MT
          • 销毁 MT
          • 查询 MT
          • 查询 MT 操作记录
          • 查询 MT 余额
          • 查询 MT 详情
        • 区块链存证接口
          • 数字作品存证接口
        • 购买能量值接口
          • 购买能量值
          • 批量购买能量值
          • 查询能量值购买结果
          • 查询能量值购买结果列表
        • 查询交易结果接口
          • 查询上链交易结果
          • 查询上链交易排队状态
  • AVATA SDK 文档
    • AVATA SDK 文档
      • AVATA v3 SDK 文档
        • Go 语言
        • JAVA 语言
      • AVATA v1 SDK 文档
        • Go 语言
        • JAVA 语言
        • PHP 语言
  • 底层链 SDK 文档
    • 底层链 SDK 文档
      • 底层链介绍
      • 底层链 API 接入说明
      • Go 语言接入教程
      • JAVA 语言接入教程
      • 文昌链最佳实践建议
  1. Web3 域名服务接口

设置域名解析

测试环境
https://stage.apis.avata.bianjie.ai
测试环境
https://stage.apis.avata.bianjie.ai
POST
https://stage.apis.avata.bianjie.ai
/v3/evm/ns/resolves/{owner}/{name}
evm
限流规则:一个域名一天内(自然天)允许解析的次数不超过10次

请求参数

Path 参数
owner
string 
域名拥有者地址
必需
name
string 
域名名称
必需
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
resolve_type
enum<integer> 
域名解析类型
必需
1:链账户 2:文本
枚举值:
12
addr
object 
链账户
可选
当 resolve_type 为 1 时,该字段为必填
addr_value
string 
链账户地址
可选
默认值为当前域名的 owner
<= 128 字符
block_chain
enum<integer> 
底层区块链
必需
1000:文昌链 - 天舟; 1001:文昌链 - 天和; 1002:文昌链 - 神舟
枚举值:
100010011002
text
object 
文本数据
可选
当 resolve_type 为 2 时,该字段为必填
key
string 
文本数据 key
必需
key 可选的标准值有:
email (电子邮箱地址);
url (网址);
avatar (用作头像或标识的图像的网址),description(域名的描述信息);
notice (关于域名的通知);
keywords (逗号分隔的关键字列表,按重要性由高到低排列,与此字段有交互的客户端可以通过设置一个阈值来选择忽略哪些内容)
<= 32 字符
text_value
string 
文本数据值
必需
<= 512 字符
operation_id
string 
必需
保证幂等性,避免重复请求,保证对于同一操作发起的一次请求或者多次请求的结果是一致的;由接入方生成并自行维护、针对每个 Project ID 唯一的、不超过 64 个大小写字母、数字、-、下划线的字符串
>= 1 字符<= 64 字符
正则匹配:
^[a-zA-Z0-9_-]+$
示例
{
    "resolve_type": 1,
    "addr": {
        "addr_value": "string",
        "block_chain": 1000
    },
    "text": {
        "key": "string",
        "text_value": "string"
    },
    "operation_id": "string"
}

返回响应

🟢200successful operation
application/json
Body
data
object 
必需
示例
{
    "data": {}
}
🟠400failed operation
上一页
查询用户域名
下一页
查询域名解析
Built with