IPDataInfo/ipdata-dotnet

# IPData.info .NET SDK — 免费 IP 地理定位与威胁情报 API [](https://www.nuget.org/packages/IPDataInfo.Sdk/) [](../../actions/workflows/ci.yml) [](./LICENSE) [**ipdata.info**](https://ipdata.info) 的官方 .NET 客户端 —— 一个免费、快速 的 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)中进行管理。 ## 安装 ``` dotnet add package IPDataInfo.Sdk ``` ## 快速开始 ``` using IPDataInfo; using var client = new IPDataClient(); // free tier; or new IPDataClient(apiKey: "KEY") var info = await client.LookupAsync("8.8.8.8"); Console.WriteLine($"{info.City}, {info.Country} ({info.AsnOrg})"); // Mountain View, United States (Google LLC) ``` ## 方法 | 方法 | 返回内容 | |--------|-----------------| | `LookupAsync(ip?)` | 完整的地理定位记录（若省略 `ip` 则为自身 IP） | | `GeoAsync(ip)` | 地理位置信息子集（城市/地区/国家/纬度/经度/时区） | | `AsnAsync(ip)` | 某个 IP 的 ASN 及 ISP/注册机构 | | `BatchAsync(ips)` | 同时查询多个 IP（**需要 API key**） | | `AsnDetailAsync(n)` | 包含前缀的 ASN 详情 | | `AsnWhoisHistoryAsync(n)` | ASN whois 历史记录 | | `AsnChangesAsync()` | ASN 变更动态 | | `ThreatDomainAsync/ThreatHashAsync/ThreatUrlAsync(x)` | 威胁情报查询（域名 / 文件哈希 / URL） | 完整响应 schema：[ipdata.info API 文档](https://ipdata.info/docs) · [SDK 列表](https://ipdata.info/docs/sdks)。 ## 配置 ``` new IPDataClient( apiKey: "KEY", // sent as X-Api-Key; switches to pro.ipdata.info baseUrl: "https://ipdata.info", // override the host httpClient: customHttpClient, // bring your own HttpClient (proxy, handlers, ...) timeout: TimeSpan.FromSeconds(5)); // ignored when httpClient is supplied ``` 非 2xx 响应引发的错误将作为 `IPDataInfo.IpDataException` 抛出，其中包含 `StatusCode` 和 `Message`。 ## 速率限制 - 免费版（`ipdata.info`）：每分钟 50 次请求，无需 key。 - 付费版（`pro.ipdata.info`）：更高的限制 + `BatchAsync`，需使用 [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)

标签：ASN查询, GitHub, IP地理定位, 多人体追踪, 威胁情报, 开发者工具