IPDataInfo/ipdata-dart

# IPData.info Dart SDK — 免费 IP 地理定位与威胁情报 API [](https://pub.dev/packages/ipdatainfo) [](../../actions/workflows/ci.yml) [](./LICENSE) [**ipdata.info**](https://ipdata.info) 的官方 Dart 客户端 — 一个免费、快速的 IP 地理定位、ASN 和威胁情报 API。查找任何 IPv4 或 IPv6 地址的国家、城市、ASN、时区、货币和安全标志（代理/VPN/Tor/托管）。由 [ipdata.info](https://ipdata.info) 提供支持。 ## 获取免费 API key 公共端点是 **免费的 — 50 次请求/分钟，无需注册，无需 key**。如需更高速率限制和批量查询，[**在 ipdata.info/register 创建一个免费的 API key**](https://ipdata.info/register)，并在您的[控制面板](https://ipdata.info/dashboard)中进行管理。 ## 安装 ``` dart pub add ipdatainfo ``` ## 快速入门 ``` import 'package:ipdatainfo/ipdatainfo.dart'; Future main() async { final client = IPDataClient(); // or IPDataClient(apiKey: 'YOUR_KEY') final info = await client.lookup('8.8.8.8'); print('${info.city}, ${info.country} (ASN ${info.asn})'); client.close(); } ``` ## 方法 | 方法 | 返回内容 | |--------|-----------------| | `lookup([ip])` | 完整的地理定位记录（如省略则查询自身 IP） | | `geo(ip)` | 地理信息子集（城市/地区/国家/纬度/经度/时区） | | `asn(ip)` | IP 的 ASN + ISP/注册机构 | | `batch(ips)` | 一次查询多个 IP（**需要 API key**） | | `asnDetail(n)` | ASN 详情，包含前缀（原始 `Map`） | | `asnWhoisHistory(n)` | ASN whois 历史记录（原始 `Map`） | | `asnChanges()` | ASN 变更动态 | | `threatDomain/Hash/Url(x)` | 威胁情报查询（域名 / 文件哈希 / URL） | ``` final geo = await client.geo('8.8.8.8'); final asn = await client.asn('8.8.8.8'); final batch = await client.batch(['8.8.8.8', '1.1.1.1']); // needs apiKey final asnDetail = await client.asnDetail(15169); final threat = await client.threatDomain('example.com'); ``` 非 2xx 响应将抛出带有 `statusCode` 和 `message` 的 `IpDataException`。 完整响应 schema：[ipdata.info API 文档](https://ipdata.info/docs) · [SDK 契约](https://ipdata.info/docs/sdks)。 ## 速率限制 - 免费版 (`ipdata.info`)：50 次请求/分钟，无需 key。 - 付费版 (`pro.ipdata.info`)：更高速率限制 + `batch`，需配合 [API key](https://ipdata.info/register) 使用。 ## 其他 SDK 12 个官方 SDK — 请在 [**ipdata.info/docs/sdks**](https://ipdata.info/docs/sdks) 查看完整列表：Python、Node.js、Go、 PHP、Java、Rust、.NET、Kotlin、Swift、Dart、Bash、Objective-C。 ## 许可证 MIT © [ipdata.info](https://ipdata.info)

标签：API客户端, Dart, GitHub, IP地理定位, 威胁情报, 实时处理, 开发者工具