帮助文档

查询用户域名

生产环境

GET

https://apis.avata.bianjie.ai/v3/evm/ns/domains/{owner}

AVATA API 文档/AVATA API 文档/AVATA v3 API 文档/智能合约模块/Web3 域名服务接口

查询某一指定链账户地址下所拥有的全部域名。

请求参数

Path 参数

owner

string

必需

当前域名拥有者的链账户地址

Query 参数

name

string

域名关键字

可选

tld

string

根域名

可选

page_key

string

可选

分页数据的Key， AVATA会根据该值进行上下页的查询，该值请从返回的数据体中获取，首页查询不传该参数

limit

string

可选

每页记录数，默认为 10，上限为 50

count_total

string

可选

是否查询数据的总数量
0：不查询总数（默认）
1：查询总数

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)

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://apis.avata.bianjie.ai/v3/evm/ns/domains/?name=&tld=&page_key=&limit=&count_total=' \
--header 'X-Api-Key;' \
--header 'X-Api-Key;' \
--header 'X-Timestamp;' \
--header 'X-Timestamp;' \
--header 'X-Signature;' \
--header 'X-Signature;'

返回响应

🟢200successful operation

application/json

Body

data

object

必需

domains

array [object {6}]

必需

prev_page_key

string

上一页数据的Key

必需

next_page_key

string

下一页数据的Key

必需

limit

integer

每页记录数

必需

total_count

integer

总记录数

必需

示例

{
  "data": {
    "domains": [
      {
        "name": "string",
        "status": 0,
        "owner": "string",
        "expire": 0,
        "expire_timestamp": "string",
        "msg": "string"
      }
    ],
    "prev_page_key": "string",
    "next_page_key": "string",
    "limit": 0,
    "total_count": 0
  }
}

🟠400failed operation

修改于 2023-10-26 02:58:43

查询域名

设置域名解析