域名查询服务的历史

概述

我们最近增强了DomainTools Whois History API端点，以帮助定制搜索，检索大型历史记录集，并允许您使用相关的历史记录进行调查。这些更新于2021年2月发布。

---

Whois历史API端点具有以下功能:

• 首先返回最近的历史记录，并根据记录日期字段按升序或降序(默认)排序。
• 允许调查人员通过分页和结果抵消检索和使用作为调查的一部分的相关历史记录。

API端点响应一次最多只能提供100条历史Whois记录。请使用新的offset参数使用分页功能检索下一组历史记录。不需要对URI结构进行其他更新。

请参阅产品服务水平而且Whois历史参数小节的优化实现。

API端点

https://api.domaintools.com/v1/DOMAIN/whois/history/ URI: /v1/{{QUERY}}/whois/history/

注意:此API中的URI模式不同于大多数其他DomainTools API，后者遵循不同的URI格式。

注:有关API端点身份验证参数和方法的更多信息，请参阅API认证界面．

先决条件

• 你必须提供正确的API凭证使用此API。
• API访问没有被禁用或过期。
• 未超过API发放服务限制。请参阅帐户信息API。

产品服务水平

产品服务级别授权您的API帐户访问API产品，并定义该访问的价格和使用限制。如果您的帐户没有权限访问某个产品，请联系DomainTools成员服务进行帮助。

您的API帐户提供了每月可以检索的历史记录的最大数量。帐户使用情况的跟踪是基于给定月份中所有域查询检索到的历史记录的数量，而不是每个API请求。使用分页和限制功能可以有效地管理您的每月消费。

Whois历史参数

示例查询-检索一个域的最古老的历史记录(升序)

免费样例查询:

https://api.domaintools.com/v1/domaintools.com/whois/history/?sort=date_asc

示例响应

{"response": {"record_count": 744， "history": [{"date": "2001-10-26"， "is_private": 0， "whois": {"registrant": "VRW2"， "registration": {"created": "1998-08-02"， "expires": "2002-08-02"， "registrar": "NETWORK SOLUTI乐动体育网址ONS, INC."， "status ": ["ACTIVE"]}， "name_servers": ["DNS1.INTERLAND. "NET"]， "server": "whois.networks乐动体育网址olutions.com"， "record": "注册人:\nVRW2\n 7770 Regents Road #113\/194\n San Diego, CA 92122\n US\n\n域名:DOMAINTOOLS.COM\n行政联系人:\n Whiting, Van R vwhiting@NABR.NET\n IPE Advisory Services\n 7770 Regents Road Suite 113\/194\n San Diego, CA 92122\n 18585347622 (FAX) 18585340756\n技术联系人:\n James, Caio cjames@YEAT.COM\n Yeat Choice Technologies\n PO Box 782\n Orangevale，CA 95662\n (619) 678-8745 (FAX) (916)729-9343\n记录最后更新日期为2001年10月26日\n记录截止日期为2002年8月02日\n记录创建日期为1998年8月02日\n数据库最后更新日期为2002年1月11日15:00:24 EST\n域服务器按顺序排列:\n\n DNS1.INTERLAND。NET 64.224.20.132\n DNS2.INTERLAND。NET 64.224.20.133\n DNS3.INTERLAND。NET 64.224.20.134\n"}}，…{"date": "2019-01-18"， "is_private": 0， "whois": {"registrant": "REDACTED FOR PRIVACY"， "registration": {"created": "1998-08-02"， "expires": "2027-08-01"， "updated": "2017-09-21"， "registrar": "eNom, Inc."， "status ": [" clienttransferforbidden "]}， "name_servers": ["NS1.P09.DYNECT. "净”、“NS2.P09.DYNECT。净”、“NS3.P09.DYNECT。净”、“NS4.P09.DYNECT。网”,“服务器”:“whois.enom.com”、“记录”:“域名:domaintools.com \ nRegistry域ID: 1697312 _domain_com-vrsn \ nRegistrar WHOIS服务器:whois.enom.com \ nRegistrar URL: WWW.ENOM.COM \ nUpdated日期:2017 - 09 - 21 t13:20:39.00z \ nCreation日期:1998 - 08 - 02 t04:00:00.00z \ nRegistrar登记截止日期:2027 - 08 - 01 - t04:00:00.00z \ nRegistrar: ENOM, INC . \ nRegistrar IANA ID: 48 \ nDomain状态:clienttransferprohibited https: www.icann.org \ / \ / \ / epp # clienttransferprohibited \ nDomain状态:registrar-lock* https:\/\/www.icann.org\/epp#registrar-lock*\ n注册人姓名:已编校的隐私\ n注册人机构:已编校的隐私\ n注册人街道:已编校的隐私\ n注册人城市:已编校的隐私\ n注册人州/省:已编校的隐私\ n注册人邮政编码:已编校的隐私\ n注册人国家:已编校的隐私\ n注册人电话:已编校的隐私\ n注册人电话next:\ n注册人传真:已编校的隐私\nAdmin用户邮箱:已编校的隐私\nAdmin名称:已编校的隐私\nAdmin组织:已编校的隐私\nAdmin街道:已编校的隐私\nAdmin城市:已编校的隐私\nAdmin州/省:已编校的隐私\nAdmin国家:已编校的隐私\nAdmin电话:已编校的隐私\nAdmin电话下一个:\nAdmin传真:已编校的隐私\nAdmin邮箱:已编校的隐私\nTech名称:已编校隐私\nTech组织:已编校隐私\nTech街道:已编校隐私\nTech城市:已编校隐私\nTech州/省:已编校隐私\nTech国家:已编校隐私\nTech电话:已编校隐私\nTech手机下一个:已编校隐私\nTech邮箱:已编校隐私\nName服务器:NS1.P09.DYNECT。NET\nName Server: NS2.P09.DYNECT。NET\nName Server: NS3.P09.DYNECT。NET\nName Server: NS4.P09.DYNECT。NET\nDNSSEC: UNSIGNED\nRegistrar滥用联系邮箱:ABUSE@ENOM.COM\nRegistrar滥用联系电话:+1.4259744689 ICANN WHOIS数据问题报告系统的nURL: HTTP:\/\/WDPRS.INTERNIC。NET\/\n"}}]}}

查询示例-检索与某个域关联的后续历史记录

免费样例查询:

https://api.domaintools.com/v1/domaintools.com/whois/history/?offset=100

示例响应片段

{“响应”:{“record_count”:744年,“历史”:[{“日期”:“2020-09-25”、“is_private”:0,“域名查询服务”:{…{"date": "2020-09-24"， "is_private": 0， "whois": {"registrant": "REDACTED FOR PRIVACY"， "registration":{…}}]}}

示例查询-使用分页检索最多20条后续历史记录

免费样例查询:

https://api.domaintools.com/v1/domaintools.com/whois/history/?offset=100&limit=20

示例响应片段

{“响应”:{“record_count”:744年,“历史”:[{“日期”:“2020-09-25”、“is_private”:0,”域名查询服务 ": { ... ){"date": "2020-09-06"， "is_private": 0， "whois": {"registrant": "REDACTED FOR PRIVACY"， "registration":{…}}]}}

其他示例回答

[HTML] (JSON) (XML)

阅读回复

响应

用于此API调用响应的容器。

record_count

此API响应“页面”中的记录数量。每个响应的默认记录数是100。使用offset参数获取后续记录。

日期

Whois记录的日期，格式为YYYY-MM-DD。

is_private

可以是0(公开可用的记录)，也可以是1(对其进行了编辑的记录)。
注意:“使用此功能过滤DomainTools已识别使用Whois隐私服务或其他数据编校实例的记录。DomainTools仅在尽力而为的基础上识别隐私服务或编校数据。”

域名查询服务

标记包含元数据和实际Whois历史记录的容器。如果在系统中存储记录时数据不可用，则某些字段值可能会丢失。

这个容器有以下属性:

• 注册人
• 登记
• 创建
• 到期
• 注册商
• 状态

name_servers

与域关联的名称服务器的主机名。

服务器

该结果中Whois记录来源的服务器。

记录

标记Whois记录的开始容器。该记录未解析。

Whois历史API数据集用例

API不包括具有相同数据的Whois记录，除非这些记录是了解域名历史所必需的。

例如，考虑以下假设的域历史:

1. 一个域名于2020年1月注册。DomainTools存储初始Whois记录。
2. 该域名的联系信息于2020年3月更改，DomainTools存储了新记录。
3. 在接下来的几个月里，该记录不会有任何变化;然而，DomainTools继续存储记录的相同快照。
4. 该域名于2021年1月出售，DomainTools存储了新的所有权记录。

在上述场景中，这些记录将表明以下内容:

• 所有权期限:第一个记录(2020年1月首次注册)与代表第一个所有者存档的最后一个记录的记录之间的时间。
• 没有所有权变更的迹象:显示2020年3月联系信息更新的记录以及该3月记录的快照的后续记录可能表明没有发生所有权变更。
• 域名所有权变更的指示以及此类变更的时间窗口:为第一个所有者记录存档的最后一个记录与显示新域所有权的第一个记录之间的日期表示域所有权发生变化的时间窗口。

API特定的错误处理

场景:检索到的部分响应(达到帐户限制)

回应:

"record_count": 91， "error": "只有部分结果已返回，因为您的每月服务水平已达到"，

有关增加帐户限额的信息，请联系企业支持enterprisesupport@domaintools.com。

有关其他通用错误处理代码和消息的详细信息，请参阅错误码页面．