apiip/apiip.net

这是 apiip.net 的官方 PHP 库,允许客户在网站、应用程序和后台系统中自动化 IP 地址验证和地理位置查询。访问我们的 API 文档:https://apiip.net/documentation

v1.2.0 2024-02-20 21:03 UTC

This package is auto-updated.

Last update: 2024-09-20 22:38:59 UTC


README

apiip.net website status Uptime Robot status Uptime Robot ratio (30 days) GitHub issues GitHub code size in bytes GitHub top language

这是 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"
  }
}

更多信息