服务器到服务器 OAuth | 文档 | 反向 IP/DNS API | WhoisXML API
产品 应用程序接口 数据源 网络工具 域名研究与监控 企业软件包
WHOIS / WHOIS历史信息
WHOIS/WHOIS历史信息

提供关于域名/IP的当前和历史所有权信息。识别域名、注册者、注册商和DNS服务器之间的所有联系。

DNS / DNS历史信息
DNS/DNS历史信息

查看域名和A、MX、NS和其他记录之间所有当前和历史的DNS/IP连接。监测DNS记录中可疑的变化。

IP地理定位/IP网块
IP地理定位/IP网块

获取一个已知IP地址的具体信息，包括其用户的地理位置、时区、连接域名、连接类型、IP范围、ASN和其他网络所有权信息。

域名查询服务（DRS）
域名查询服务（DRS）

访问网络版的解决方案，挖掘和监测所有域名相关事件。

域名查询服务（DRS）
域名查询服务（DRS）

获得网络版企业级解决方案，以搜索和监控域名注册和所有权细节，了解品牌术语、模糊匹配、感兴趣的注册者等。

研究
监测
白色标签
WhoisXML API 预测威胁情报
预测性威胁情报

在恶意行为者将危险域名变为武器之前，检测并阻止对这些域名的访问。如需了解更多信息，请立即联系我们。

WhoisXML API 互联网基础设施
互联网基础设施

获取有关互联网属性及其所有权、基础设施和其他属性的综合情报。

企业API套餐
企业API套餐

域名、IP和DNS情报套餐可通过API查询，以可预测的价格进行每年订阅。

安全情报信息（SI）套餐
安全情报信息（SI）套餐

可为丰富产品内容和威胁狩猎等需求完整访问WHOIS、IP、DNS和子域名数据库。

高级API服务
高级API服务

通过API优享服务获取优先的数据访问，另有额外福利，包括专业的团队支持、企业级的基础设施和SLA，以实现全面的可扩展性和高性能。

多级应用程序接口用户管理功能现已推出--管理企业中团队成员的个人应用程序接口密钥。

了解更多
×
联系我们
API文档 集成 价格 博客
发出请求 输出格式 错误代码 服务器到服务器 OAuth
余额信息 生成新的 API 密钥

服务器到服务器 OAuth

发出 API 请求时，使用服务器到服务器 OAuth 对 WhoisXML API 进行身份验证。这 也被称为 "双脚 OAuth"，因为它使用两步流程，不需要用户交互进行 验证或授权。流程如下

  • 服务器到服务器 OAuth 客户端向 WhoisXML API 授权服务器请求访问令牌。
  • 您的客户端使用访问令牌发出 API 请求。

您还可以查看GitHub 上的脚本，了解如何将 WHOIS API 与服务器端 SSO 结合使用。

生成访问令牌

使用 访问令牌授权类型生成访问令牌。这种授权类型的特点是

  • 令牌的生命周期为 1800 秒（30 分钟）、3600 秒（1 小时）、7200 秒（2 小时）或 10800 秒（3 小时）。默认为 3600 秒（1 小时）。
  • 没有刷新令牌。
  • 您可以生成和使用多个访问令牌。
  • 生成新的 API 密钥后，之前生成的所有访问令牌都会失效。
  • 生成的访问令牌对您可以访问的任何产品都有效。

请注意，生成的 访问令牌而不是 apiKey参数。

API端点

职位 https://main.whoisxmlapi.com/oauth/token 
curl --location 'https://main.whoisxmlapi.com/oauth/token' \
--header 'Authorization: Bearer %base64_encoded_API_key%' \
--header 'Content-Type: application/json' \
--data '{
    "grantType": "access_token",
    "expiresIn": 7200
}'

页眉

授权

必须填写。Base64 编码的 API 密钥。

验证方案：承载器

在"我的产品"页面获取个人 API 密钥。

输入参数

grantType

必须填写。用于生成访问令牌的授权类型。

接受值：access_token。
过期

可选项。访问令牌的有效期，以秒为单位。

可接受的值：1800 , 3600 , 7200 , 10800.

默认值：3600。
输出格式

选填。结果输出格式。

可接受的值： JSON | XML

默认值： JSON

回应

{
    "accessToken": "G2OIE2AKRCVDYFUJCV5PXXXXXXXXXXXX",
    "expiresIn": 3600
}

使用 访问令牌值来验证 API 请求。将生成的值代入 apiKey字段，就像使用普通 API 密钥一样。

错误

{
    "code": 401,
    "messages": "Access restricted. Check the credits balance or enter the correct API key."
}
{
    "code": 422,
    "messages": {
        "grantType": [
            "The selected grant type is invalid."
        ]
    }
}

使用访问令牌的 cURL WHOIS API GET 请求示例

curl --location 'https://www.whoisxmlapi.com/whoisserver/WhoisService?domainName=google.com' \
--header 'Authorization：Bearer %accessToken%'

使用访问令牌的 cURL WHOIS API POST 请求示例

curl --location 'https://www.whoisxmlapi.com/whoisserver/WhoisService' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer %accessToken%' \
    --data '{
        "domainName": "google.com"
    }'