跳到正文
ipaddress.tr

API

与网站相同的数据，以 JSON 或纯文本提供。无需密钥和账户，适用合理的频率限制。

curl https://ipaddress.tr/api/v1/my-ip?format=text

接口

路径说明数据频率限制
GET/api/v1/my-ip试一试: /api/v1/my-ip你的 IP 地址（加 ?format=text 可获得纯文本）。自有数据集120 · 240/分钟
GET/api/v1/ip/{address}试一试: /api/v1/ip/144.122.145.153某个地址的网络、路由、注册和位置数据。自有数据集30 · 30/分钟
GET/api/v1/ip/geolocation?ip=试一试: /api/v1/ip/geolocation?ip=177.224.0.1仅返回地址的估计位置（DB-IP Lite），始终标注为估计值。自有数据集30 · 30/分钟
GET/api/v1/ip/asn?ip=试一试: /api/v1/ip/asn?ip=2001:1208::1地址的源AS和宣告前缀，以及其所在的注册分配。自有数据集30 · 30/分钟
GET/api/v1/ip/reverse?ip=试一试: /api/v1/ip/reverse?ip=8.8.8.8公网地址的PTR记录，实时查询并经正向确认。实时查询40 · 60/分钟
GET/api/v1/ip/blacklist?ip=试一试: /api/v1/ip/blacklist?ip=8.8.8.8公网地址的实时DNSBL结果（SpamCop、PSBL、DroneBL、s5h.net）及Tor出口标记。实时查询40 · 60/分钟
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.tr/api/v1/bulk一次最多 100 个地址(JSON {"addresses": […]} 或每行一个),仅由我们自己的数据集回答,不保存任何内容。自有数据集6 · 3/分钟
GET/api/v1/asn/{asn}试一试: /api/v1/asn/AS8151自治系统的持有者、注册机构和宣告的前缀。自有数据集30 · 30/分钟
GET/api/v1/network/{cidr}试一试: /api/v1/network/144.122.0.0/16CIDR表示的网络：大小、范围、特殊用途状态、谁在宣告（含RPKI）、注册分配信息和位置估计。自有数据集30 · 30/分钟
GET/api/v1/network/ipv4?cidr=试一试: /api/v1/network/ipv4?cidr=192.168.1.37/24IPv4或IPv6网络的子网计算：网络地址、广播地址、掩码、可用范围和数量。自有数据集120 · 240/分钟
GET/api/v1/network/ipv6?cidr=试一试: /api/v1/network/ipv6?cidr=2001:db8::/48IPv4或IPv6网络的子网计算：网络地址、广播地址、掩码、可用范围和数量。自有数据集120 · 240/分钟
GET/api/v1/country/{cc}试一试: /api/v1/country/MX某个国家注册的地址空间和 AS 号、其网络宣告的内容、RPKI 覆盖率和最大的网络（土耳其 TR 还包括按省估算）。自有数据集30 · 30/分钟
GET/api/v1/dns/{domain}?type=A,MX试一试: /api/v1/dns/metu.edu.tr?type=A,MX域名的当前 DNS 记录。实时查询40 · 60/分钟
GET/api/v1/dns/propagation?name=&type=试一试: /api/v1/dns/propagation?name=metu.edu.tr&type=A向多个公共解析器提出同一DNS问题，返回各自的答案以及是否一致。实时查询40 · 60/分钟
GET/api/v1/rdap/{query}试一试: /api/v1/rdap/AS8151来自负责 RDAP 服务器的注册数据。实时查询10 · 6/分钟
GET/api/v1/health试一试: /api/v1/health服务是否在运行。自有数据集120 · 240/分钟
GET/api/v1/data-status试一试: /api/v1/data-status各数据集的新旧程度和大小。自有数据集120 · 240/分钟

/api/v1 之外的纯文本快捷方式：/raw 输出你的地址，/json 返回与 /my-ip 相同的对象，/country 返回估计的国家代码。

每个路径式端点也有查询参数形式：/ip/lookup?ip=、/asn/lookup?asn=、/dns/lookup?name=、/network/cidr?cidr=。每个响应都带有 X-Request-Id 头。

curl ipaddress.tr/rawcurl ipaddress.tr/jsoncurl ipaddress.tr/country

频率限制

请求按客户端地址使用令牌桶限流。达到上限时，API 返回 429 及 Retry-After 标头。计数在内存中使用每天轮换的哈希键，不保存地址。

错误

错误使用 HTTP 状态码，以及形如 {"error": {"code": "…", "message": "…"}} 的 JSON 正文。

版本

/api/v1/ 下的路径保持响应结构不变。可能新增字段，但在 v1 中不会删除或重命名现有字段。

署名

位置数据来自 DB-IP（CC BY 4.0）。如果展示这些数据，请按许可要求注明 DB-IP。