apiip / apiip.net
这是 apiip.net 的官方 PHP 库,允许客户在网站、应用程序和后台系统中自动化 IP 地址验证和地理位置查询。访问我们的 API 文档:https://apiip.net/documentation
v1.2.0
2024-02-20 21:03 UTC
Requires
- php: >=7.4
- ext-json: *
- guzzlehttp/guzzle: ^6.3||^7.0
README
这是 apiip.net IP 地址地理位置 API 的官方 PHP 客户端库,允许您查找自己的 IP 地址或获取任何 IP 的详细信息。
使用 apiip.net API 从 IP 地址(例如城市、国家、经纬度)获取地理位置数据。
apiip.net 每月提供 1,000 个免费请求。对于更高计划,请查看 网站
安装
您需要从这里获取您的 API 密钥:https://apiip.net/get-started,您将获得每月 1,000 个免费请求
使用以下命令安装包
composer require apiip/apiip.net
用法
该包需要配置您的账户 API 密钥,该密钥可在 apiip.net 控制台 获取
use ApiipClient\Apiip; $access_key = 'YOUR_ACCESS_KEY'; $client = new Apiip($access_key); $details = $client->getLocation(); $details['city']; Belgrade
HTTPS 加密
默认情况下,SSL/TLS 已启用,如果要禁用它,请传递选项参数
示例
use ApiipClient\Apiip; $access_key = 'YOUR_ACCESS_KEY'; $client = new Apiip($access_key, ['ssl' => false]);
配置
使用配置对象调用 getLocation 方法
use ApiipClient\Apiip; $access_key = 'YOUR_ACCESS_KEY'; $client = new Apiip($access_key); $details = $client->getLocation([ 'ip' => $ip_address, // 67.250.186.196, 188.79.34.191, 60.138.7.24 - for bulk request 'output' => 'xml', 'fields' => 'city,country', 'languages' => 'es' ]);
示例完整响应
{ "ip": "67.250.186.196", "continentCode": "NA", "continentName": "North America", "countryCode": "US", "countryName": "United States", "countryNameNative": "United States", "city": "New York", "postalCode": "10001", "latitude": 40.8271, "longitude": -73.9359, "capital": "Washington D.C.", "phoneCode": "1", "countryFlagEmoj": "🇺🇸", "countryFlagEmojUnicode": "U+1F1FA U+1F1F8", "isEu": false, "borders": [ "CAN", "MEX" ], "topLevelDomains": [ ".us" ], "languages": { "en": { "code": "en", "name": "English", "native": "English" } }, "currency": { "code": "USD", "name": "US Dollar", "symbol": "$", "number": "840", "rates": { "EURUSD": 1.11 } }, "timeZone": { "id": "America/New_York", "currentTime": "10/26/2021, 2:54:10 PM", "code": "EDT", "timeZoneName": "EDT", "utcOffset": -14400 }, "userAgent": { "isMobile": false, "isiPod": false, "isTablet": false, "isDesktop": true, "isSmartTV": false, "isRaspberry": false, "isBot": false, "browser": "Chrome", "browserVersion": "100.0.4896.127", "operatingSystem": "Windows 10.0", "platform": "Microsoft Windows", "source": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.127 Safari/537.36" }, "connection": { "asn": 12271, "isp": "Charter Communications Inc" }, "security": { "isProxy": false, "isBogon": false, "isTorExitNode": false, "isCloud": false, "isHosting": false, "isSpamhaus": false, "suggestion": "allow", "network": "67.250.176.0/20" } }