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。