跳到正文
ipaddress.se

API

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

curl https://ipaddress.se/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/81.224.0.1某个地址的网络、路由、注册和位置数据。自有数据集30 · 30/分钟
GET/api/v1/asn/{asn}试一试: /api/v1/asn/AS3301自治系统的持有者、注册机构和宣告的前缀。自有数据集30 · 30/分钟
GET/api/v1/dns/{domain}?type=A,MX试一试: /api/v1/dns/internetstiftelsen.se?type=A,MX域名的当前 DNS 记录。实时查询40 · 60/分钟
GET/api/v1/rdap/{query}试一试: /api/v1/rdap/AS3301来自负责 RDAP 服务器的注册数据。实时查询10 · 6/分钟
GET/api/v1/health试一试: /api/v1/health服务是否在运行。自有数据集120 · 240/分钟
GET/api/v1/data-status试一试: /api/v1/data-status各数据集的新旧程度和大小。自有数据集120 · 240/分钟

频率限制

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

错误

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

版本

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

署名

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