跳到正文

域名Whois查询

接口说明

查询域名注册信息的接口(whois/rdap 两类来源) 该接口是一个域名注册信息查询接口, 能对域名的whois记录进行查询。仅支持域名whois查询。使用url路径参数输入一个域名实现查询。返回该域名当前最新的注册信息,返回信息包括域名注册时间、更新时间、注册人、注册邮箱、nameserver等能解析到的全部whois信息。

请求地址

https://api.f.360.cn/domains/std/v1/whoisdb/detail/:domain

请求方法

GET

请求参数

参数名类型位置是否必填示例值说明
domainStringpath是baidu.com查询域名
limitIntquery否10翻页
offsetIntquery否0返回条目

响应参数

名称字段类型示例值描述
r_domainnamestringinstreet.cc域名
whoisserverArray
[
  "grs-whois.hichina.com"
]
whois服务器
domainnameArray
[
  "instreet.cc"
]
域名
nameserversArray
[
  "dns10.hichina.com",
  "dns9.hichina.com"
]
nameserver
expiresdateArray
[
  "2026-11-19 13:48:20"
]
whois过期时间
registrarnameArray
[
  "Alibaba Cloud Computing (Beijing) Co., Ltd."
]
注册商
updateddateArray
[
  "2016-11-21 09:12:57"
]
whois更新时间
sourceArray
[
  "netlab",
  "netlab-whoisapi"
]
源
createddateArray
[
  "2015-11-19 13:48:20"
]
whois创建时间
first_seenString2019-07-08 15:00:00首次发现入库时间
last_seenString2023-07-08 15:00:00最后发现入库时间
statusArray(string)
[
  "active",
  "ok",
  "clientTransferProhibited"
]
whois状态
registrant_emailArray(string)
[
  "user@example.com"
]
注册人邮箱
registrant_nameArray(string)
[
  "John Doe"
]
注册人
registrant_organizationArray(string)
[
  "Example Inc."
]
注册人组织
registrant_addressArray(string)
[
  "123 Main St",
  "Suite 100"
]
注册人地址
registrant_cityArray(string)
[
  "San Francisco"
]
注册人城市
registrant_stateArray(string)
[
  "CA"
]
注册人洲
registrant_postalcodeArray(string)
[
  "94105"
]
注册人邮编
registrant_countryArray(string)
[
  "US"
]
注册人国家
registrant_faxArray(string)
[
  "+1.123456789"
]
注册人传真
registrant_telephoneArray(string)
[
  "+1.987654321"
]
注册人电话
admin_emailArray(string)-管理员邮箱
admin_nameArray(string)-管理联系人
admin_organizationArray(string)-管理联系人组织
admin_addressArray(string)-管理联系人地址
admin_cityArray(string)-管理联系人城市
admin_stateArray(string)-管理联系人洲
admin_postalcodeArray(string)-管理联系人编
admin_countryArray(string)-管理联系人国家
admin_faxArray(string)-管理联系人传真
admin_telephoneArray(string)-管理联系人电话
billing_*Array(string)-财务联系人*
tech_*Array(string)-技术联系人*
zone_*Array(string)-DNS区域联系人*

请求示例

支持cUrl、Python、Java、PHP、Go语言的请求,示例如下

#!/usr/bin/env bash
set -euo pipefail

APPID=""  # apikey
SECRET=""  # salt
URL="https://api.f.360.cn/domains/std/v1/whoisdb/detail/baidu.com?limit=10"
BODY=""

NONCE=$(printf '%08d' $((RANDOM % 100000000)))
TIMESTAMP=$(date +%s)
BODY_MD5=$(printf '%s' "$BODY" | openssl dgst -md5 -hex | awk '{print $NF}')
SIGNATURE=$(printf '%s' "${BODY_MD5}${APPID}${NONCE}${TIMESTAMP}${SECRET}" | openssl dgst -md5 -hex | awk '{print $NF}')
SIGNATURE=${SIGNATURE:16}

curl --location --request GET "$URL" \
  --header "Content-Type: application/json" \
  --header "X-360-Key: ${APPID}" \
  --header "X-360-Nonce: ${NONCE}" \
  --header "X-360-Timestamp: ${TIMESTAMP}" \
  --header "X-360-Signature: ${SIGNATURE}"

响应示例

业务正常响应

{
    "code": "0",
    "msg": "ok",
    "data": [
        {
            "status": [
                "ok"
            ],
            "r_domainname": "instreet.cc",
            "whoisserver": [
                "grs-whois.hichina.com"
            ],
            "domainname": [
                "instreet.cc"
            ],
            "nameservers": [
                "dns10.hichina.com",
                "dns9.hichina.com"
            ],
            "expiresdate": [
                "2026-11-19 13:48:20"
            ],
            "registrarname": [
                "Alibaba Cloud Computing (Beijing) Co., Ltd."
            ],
            "updateddate": [
                "2016-11-21 09:12:57"
            ],
            "source": [
                "netlab",
                "netlab-whoisapi"
            ],
            "createddate": [
                "2015-11-19 13:48:20"
            ],
            "first_seen": "2019-07-08 15:00:00",
            "last_seen": "2023-06-02 20:26:06"
        }
    ]
}

业务异常响应

{
    "code": "GT00201",
    "msg": "服务请求异常"
}