域名 WHOIS 查询

GET
https://api.xuewutheme.com/api/info/whois

查询域名的注册信息、状态、DNS服务器等详细信息

接口概述

请求示例: https://api.xuewutheme.com/api/info/whois?apikey=用户开通的apikey&domain=baidu.com

查询域名的注册信息、状态、DNS服务器等详细信息

请求参数

参数名 类型 必填 描述
apikey string 整数 string

用户开通的apikey

domain string 整数 string

域名

响应参数

成功响应

状态码: 200 OK
格式: json
参数名 类型 描述
code integer integer

返回的状态码

data object object

返回的数据/数据对象

msg string string

返回的消息

time string string

请求时间

data.domain string string

域名

data.domain_age string string

域名年龄

data.registrar string string

注册商

data.whois_server string string

WHOIS服务器

data.updated_date string string

更新时间

data.creation_date string string

创建时间

data.expiration_date string string

过期时间

data.registrar_id string string

注册商ID

data.status array array

域名状态列表

data.name_servers array array

DNS服务器列表

data.dnssec string string

DNSSEC配置状态

响应示例

JSON
{
    "code": 200,
    "data": {
        "creation_date": "1999-10-11 19:05:17",
        "dnssec": "not configured",
        "domain": "baidu.com",
        "domain_age": "26 years",
        "expiration_date": "2026-10-11 19:05:17",
        "name_servers": [
            "ns1.baidu.com",
            "ns2.baidu.com",
            "ns3.baidu.com",
            "ns4.baidu.com",
            "ns7.baidu.com"
        ],
        "registrar": "MarkMonitor, Inc.",
        "status": [
            "clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited",
            "clientTransferProhibited https://icann.org/epp#clientTransferProhibited",
            "clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited",
            "serverDeleteProhibited https://icann.org/epp#serverDeleteProhibited",
            "serverTransferProhibited https://icann.org/epp#serverTransferProhibited",
            "serverUpdateProhibited https://icann.org/epp#serverUpdateProhibited",
            "clientUpdateProhibited (https://www.icann.org/epp#clientUpdateProhibited)",
            "clientTransferProhibited (https://www.icann.org/epp#clientTransferProhibited)",
            "clientDeleteProhibited (https://www.icann.org/epp#clientDeleteProhibited)",
            "serverUpdateProhibited (https://www.icann.org/epp#serverUpdateProhibited)",
            "serverTransferProhibited (https://www.icann.org/epp#serverTransferProhibited)",
            "serverDeleteProhibited (https://www.icann.org/epp#serverDeleteProhibited)"
        ],
        "updated_date": "2023-11-30 14:00:19",
        "whois_server": "whois.markmonitor.com"
    },
    "msg": "请求成功!",
    "time": "2025-03-11 21:57:00"
}

请求示例

cURL

Bash
curl -X GET \
  "https://api.example.com/v1/users/12345" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json"

Python

Python
import requests

url = "https://api.example.com/v1/users/12345"
headers = {
    "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

JavaScript

JavaScript
const response = await fetch(
  'https://api.example.com/v1/users/12345',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
      'Content-Type': 'application/json'
    }
  }
);

const data = await response.json();
console.log(data);

PHP

PHP
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://api.example.com/v1/users/12345");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");

$headers = array();
$headers[] = "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

curl_close($ch);

错误码

状态码 描述
100 您的apikey值为空!
101 您的apikey值不存在!
103 当前接口为实名认证后可用,请您先进行实名!
104 请求频率超限!
105 接口不存在或已下线!
106 您的余额不足,请及时充值!
107 您当前的接口免费使用次数已用完,请明日再来!
109 您的账号已被封禁,不可使用任何接口!
110 接口维护中,请稍后再试!
111 请求参数不完整,请检查后再次访问!

错误响应示例

JSON
{
  "code": 1001,
  "message": "用户不存在",
  "data": null
}