查询域名

生产环境

https://apis.avata.bianjie.ai

GET

/v2/ns/domains

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

在进行域名注册前，可先调用该接口对某一指定一级域名的状态进行查询，以确保该域名是否可以注册或续费。

请求参数

Query 参数

name

string

必需

域名关键字，包含大小写英文字母、阿拉伯数字和连字符 -

示例值:

test

tld

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)

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://apis.avata.bianjie.ai/v2/ns/domains?name=test' \
--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}]

必需

示例

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

转让域名

查询用户域名