发出请求 |文档 | IP 网块 API | WhoisXML API

发出请求

API端点

结果 https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&ip=8.8.8.8
结果 https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&ip=2001:0000:4136:e378::
结果 https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&ip=8.8.8.8&mask=16
结果 https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&org[]=apple&org[]=germany
结果 https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&asn=2544
注册后将花费一分钟激活帐户。

Postman 集合

Postman 是一个桌面和 Web 应用程序,可通过图形用户界面向 API 发出请求。在探索 API 功能以及解决应用程序问题时,我们建议将 Postman 与 WhoisXML API 端点结合使用。

WhoisXML API Postman 集合可从以下链接获得:

该集合包括一个预配置的环境,可通过设置api_key变量来触发每个请求。在“我的产品”页面获取个人 API KEY 。如果对 API 有任何疑问,请联系我们

输入参数:必填

apiKey

“我的产品”页面获取个人 API KEY。

IP

需要以下输入字段之一: iporgasn 。根据输入,通过 IPv4/IPv6 地址或 CIDR 获取范围。此外,为方便操作,可以使用可选的掩码参数按 CIDR 进行搜索。

org

需要以下输入字段之一: iporgasn 。在网块(网络名称、描述、备注)或机构(org.org、org.name、org.email、org.address)字段中通过特定搜索词检索IP网块。提供多个术语: ?org[]=term1&org[]=term2&org[]=term3

asn

需要以下输入字段之一: iporgasn 。按 ASN(自治系统编号)获取范围。

输入参数:选填

outputFormat

响应输出格式。

可接受的值: JSON | XML

默认值: JSON

mask

仅对ip参数选填。通过 CIDR 获取范围。

可接受的值: 0 - 128(IPv4 为 0 - 32)

默认值: 128

limit

返回记录的最大数量。

可接受的值: 1 - 1000

默认值: 100

from

IP 网块范围可作为返回结果的偏移量。

由于每个结果响应都有限制记录(默认为 100),可以将响应结果中的下一个参数放入此参数来检索下一页。例如,一个参数是“6.0.0.0-13.115.255.255”,可检索下一页,则调用查询 https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&ip=8.8.8.8&limit=5&from=6.0.0.0-13.115.255.255

如果省略该参数,将获得最多的限制记录(默认为 100)。

如果next参数为null ,则没有下一页。

此类分页仅适用于 IPv4、IPv6 和 ASN API 请求。 ORG 请求不支持。

免费访问

注册后,用户将自动获取一个免费订阅计划,查询上限为1,000次。

使用限制和请求限制

每秒最大请求数为100 。如果超过限制,后续请求将被拒绝,直到下一秒

此 API 也可与专用负载平衡器和高级端点一起使用,以作为我们的高级版 API 服务企业 API 套餐的一部分实现更快的查询。