域名Whois查询
接口说明
查询域名注册信息的接口(whois/rdap 两类来源) 该接口是一个域名注册信息查询接口, 能对域名的whois记录进行查询。仅支持域名whois查询。使用url路径参数输入一个域名实现查询。返回该域名当前最新的注册信息,返回信息包括域名注册时间、更新时间、注册人、注册邮箱、nameserver等能解析到的全部whois信息。
请求地址
https://api.f.360.cn/domains/std/v1/whoisdb/detail/:domain
请求方法
GET
请求参数
| 参数名 | 类型 | 位置 | 是否必填 | 示例值 | 说明 |
|---|---|---|---|---|---|
| domain | String | path | 是 | baidu.com | 查询域名 |
| limit | Int | query | 否 | 10 | 翻页 |
| offset | Int | query | 否 | 0 | 返回条目 |
响应参数
| 名称 | 字段类型 | 示例值 | 描述 |
|---|---|---|---|
| r_domainname | string | instreet.cc | 域名 |
| whoisserver | Array | | whois服务器 |
| domainname | Array | | 域名 |
| nameservers | Array | | nameserver |
| expiresdate | Array | | whois过期时间 |
| registrarname | Array | | 注册商 |
| updateddate | Array | | whois更新时间 |
| source | Array | | 源 |
| createddate | Array | | whois创建时间 |
| first_seen | String | 2019-07-08 15:00:00 | 首次发现入库时间 |
| last_seen | String | 2023-07-08 15:00:00 | 最后发现入库时间 |
| status | Array(string) | | whois状态 |
| registrant_email | Array(string) | | 注册人邮箱 |
| registrant_name | Array(string) | | 注册人 |
| registrant_organization | Array(string) | | 注册人组织 |
| registrant_address | Array(string) | | 注册人地址 |
| registrant_city | Array(string) | | 注册人城市 |
| registrant_state | Array(string) | | 注册人洲 |
| registrant_postalcode | Array(string) | | 注册人邮编 |
| registrant_country | Array(string) | | 注册人国家 |
| registrant_fax | Array(string) | | 注册人传真 |
| registrant_telephone | Array(string) | | 注册人电话 |
| admin_email | Array(string) | - | 管理员邮箱 |
| admin_name | Array(string) | - | 管理联系人 |
| admin_organization | Array(string) | - | 管理联系人组织 |
| admin_address | Array(string) | - | 管理联系人地址 |
| admin_city | Array(string) | - | 管理联系人城市 |
| admin_state | Array(string) | - | 管理联系人洲 |
| admin_postalcode | Array(string) | - | 管理联系人编 |
| admin_country | Array(string) | - | 管理联系人国家 |
| admin_fax | Array(string) | - | 管理联系人传真 |
| admin_telephone | Array(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}"# python3.6.8
# -*- coding:utf-8 -*—
import hashlib
import random
import time
import requests
APPID = "" # apikey
SECRET = "" # salt
def make_headers(appid, secret, body=""):
headers = {}
headers["X-360-Key"] = appid
headers["X-360-Nonce"] = str(random.randint(0, 99999999)).zfill(8)
headers["X-360-Timestamp"] = str(int(time.time()))
s = (
hashlib.md5(body.encode("utf8")).hexdigest()
+ headers["X-360-Key"]
+ headers["X-360-Nonce"]
+ headers["X-360-Timestamp"]
+ secret
)
md5 = hashlib.md5(s.encode("utf8")).hexdigest()
headers["X-360-Signature"] = md5[16:]
headers["Content-Type"] = "application/json"
return headers
def do_get(url, params):
res = requests.get(url, headers=make_headers(APPID, SECRET), params=params)
print(res.text)
if __name__ == "__main__":
# 请求地址
url = "https://api.f.360.cn/domains/std/v1/whoisdb/detail/baidu.com"
params = {"limit": 10}
do_get(url, params)import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.util.concurrent.ThreadLocalRandom;
public class Demo {
static String md5(String input) throws Exception {
byte[] digest = MessageDigest.getInstance("MD5")
.digest(input.getBytes(StandardCharsets.UTF_8));
StringBuilder sb = new StringBuilder();
for (byte b : digest) {
sb.append(String.format("%02x", b & 0xff));
}
return sb.toString();
}
public static void main(String[] args) throws Exception {
String appid = ""; // apikey
String secret = ""; // salt
String url = "https://api.f.360.cn/domains/std/v1/whoisdb/detail/baidu.com?limit=10";
String body = "";
String nonce = String.format("%08d", ThreadLocalRandom.current().nextInt(100000000));
String timestamp = String.valueOf(System.currentTimeMillis() / 1000);
String signature = md5(md5(body) + appid + nonce + timestamp + secret).substring(16);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(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)
.GET()
.build();
HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(
request, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8));
System.out.println(response.body());
}
}<?php
// apikey
$appid = "";
// salt
$secret = "";
$url = 'https://api.f.360.cn/domains/std/v1/whoisdb/detail/baidu.com?limit=10';
$body = "";
$nonce = str_pad((string) random_int(0, 99999999), 8, "0", STR_PAD_LEFT);
$timestamp = (string) time();
$signature = substr(md5(md5($body) . $appid . $nonce . $timestamp . $secret), 16);
$ch = curl_init($url);
$options = [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-360-Key: {$appid}",
"X-360-Nonce: {$nonce}",
"X-360-Timestamp: {$timestamp}",
"X-360-Signature: {$signature}",
],
];
$options[CURLOPT_HTTPGET] = true;
curl_setopt_array($ch, $options);
$response = curl_exec($ch);
if ($response === false) {
echo curl_error($ch), PHP_EOL;
} else {
echo $response, PHP_EOL;
}
curl_close($ch);package main
import (
"crypto/md5"
"encoding/hex"
"fmt"
"io"
"math/rand"
"net/http"
"time"
)
func md5Hex(s string) string {
sum := md5.Sum([]byte(s))
return hex.EncodeToString(sum[:])
}
func main() {
appid := "" // apikey
secret := "" // salt
url := "https://api.f.360.cn/domains/std/v1/whoisdb/detail/baidu.com?limit=10"
body := []byte("")
nonce := fmt.Sprintf("%08d", rand.Intn(100000000))
timestamp := fmt.Sprintf("%d", time.Now().Unix())
signature := md5Hex(md5Hex(string(body)) + appid + nonce + timestamp + secret)[16:]
req, err := http.NewRequest(http.MethodGet, url, nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-360-Key", appid)
req.Header.Set("X-360-Nonce", nonce)
req.Header.Set("X-360-Timestamp", timestamp)
req.Header.Set("X-360-Signature", signature)
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
respBody, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(respBody))
}响应示例
业务正常响应
{
"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": "服务请求异常"
}