IPDataInfo/ipdata-php
GitHub: IPDataInfo/ipdata-php
ipdata.info 的官方 PHP SDK,为 PHP 应用提供 IP 地理定位、ASN 查询与威胁情报 API 接入能力。
Stars: 3 | Forks: 0
# IPData.info PHP SDK — 免费 IP 地理定位与威胁情报 API
[](https://packagist.org/packages/ipdatainfo/sdk) [](../../actions/workflows/ci.yml) [](./LICENSE)
[**ipdata.info**](https://ipdata.info) 的官方 PHP 客户端 —— 一个免费的、
快速的 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)中进行管理。
## 安装
```
composer require ipdatainfo/sdk
```
## 快速开始
```
lookup('8.8.8.8');
echo "{$info['city']}, {$info['country']} ({$info['asn_org']})\n"; // Mountain View, United States (Google LLC)
```
## 方法
| 方法 | 返回内容 |
|--------|-----------------|
| `lookup(ip = '')` | 完整的地理定位记录(如省略则查询自身 IP) |
| `geo(ip)` | 地理位置子集(城市/地区/国家/纬度/经度/时区) |
| `asn(ip)` | 某个 IP 的 ASN + ISP/注册机构 |
| `batch(ips)` | 一次查询多个 IP(**需要 API key**) |
| `asnDetail(n)` | ASN 详情,包含前缀 |
| `asnWhoisHistory(n)` | ASN whois 历史 |
| `asnChanges()` | ASN 变更动态 |
| `threatDomain/threatHash/threatUrl(x)` | 威胁情报查询(域名 / 文件哈希 / URL) |
完整响应 schema:[ipdata.info API 文档](https://ipdata.info/docs) ·
[SDK 列表](https://ipdata.info/docs/sdks)。
## 配置
```
new Client(
apiKey: 'YOUR_API_KEY', // sent as X-Api-Key; switches to pro.ipdata.info
baseUrl: 'https://ipdata.info', // optional override
timeout: 10.0, // seconds
);
```
非 2xx 响应引发的错误将以 `IPDataInfo\IpDataException` 形式抛出,
包含 `getStatusCode()` 方法以及来自 API `{"error": "..."}` 响应体的错误信息。
## 速率限制
- 免费(`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客户端, ffuf, IP地理定位, OpenVAS, PHP, 威胁情报, 实时处理, 开发者工具