该示例代码适用于 www.apispace.com 网站下 API，使用该产品前，您需要通过以下链接订阅服务：https://www.apispace.com/eolink/api/ipguishu/api/
### APISpace IP归属地 API接口 PHP调用详解
#### 一、概述
APISpace 是一个中立的API社区平台，旨在为用户提供一个高效、可靠的服务环境来查找、开发、购买、测试以及使用API。它能够自动为社区中的API进行评分，并提供包括性能、稳定性、更新频次、活跃程度等在内的多项指标，从而帮助用户更好地选择适合自己需求的API服务。本文将详细介绍如何使用PHP语言调用APISpace提供的“IP归属地”API接口。
#### 二、API介绍
##### 1. API名称：IP归属地
该API的主要功能是根据输入的IP地址查询其归属地信息，这些信息通常包括但不限于国家、省份、城市、区县以及ISP（互联网服务提供商）等。
##### 2. 支持的APIs
- **IP归属地-区县级**：提供更为精确的查询结果，具体到区县级别的位置信息。
#### 三、调用前准备
在正式调用API之前，需要完成以下准备工作：
1. **注册与认证**：访问APISpace官方网站（[www.apispace.com](https://www.apispace.com)），完成用户注册并登录账号。
2. **订阅服务**：点击链接 [https://www.apispace.com/eolink/api/ipguishu/api/](https://www.apispace.com/eolink/api/ipguishu/api/)，按照页面指引订阅相应的服务项目。
3. **获取API密钥**：成功订阅后，您将获得一个API密钥（Token），该密钥用于身份验证。
#### 四、PHP调用示例
以下是一个简单的PHP示例代码，演示如何使用PHP语言调用“IP归属地-区县级”API：
```php
<?php
// 初始化cURL会话
$curl = curl_init();
// 设置cURL选项
curl_setopt_array($curl, array(
CURLOPT_URL => "https://eolink.o.apispace.com/ipguishu/ip/geo/v1/district?ip=1.45.124.145&coordsys=WGS84", // API请求URL
CURLOPT_RETURNTRANSFER => true, // 将cURL执行结果作为字符串返回
CURLOPT_ENCODING => "", // 不使用编码压缩
CURLOPT_MAXREDIRS => 10, // 最大重定向次数
CURLOPT_TIMEOUT => 30, // 超时时间
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, // 使用HTTP版本1.1
CURLOPT_CUSTOMREQUEST => "GET", // 使用GET方法
CURLOPT_POSTFIELDS => "", // POST请求数据为空
CURLOPT_HTTPHEADER => array( // 自定义HTTP头
"X-APISpace-Token: YOUR_API_TOKEN_HERE", // 替换为您的API Token
"Authorization-Type: apikey" // 授权类型
),
));
// 执行cURL会话
$response = curl_exec($curl);
// 检查错误
$err = curl_error($curl);
// 关闭cURL会话
curl_close($curl);
// 输出结果或错误
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response; // 输出响应内容
}
?>
```
#### 五、注意事项
- 在上述代码中，“YOUR_API_TOKEN_HERE”需要替换为您实际获取的API Token。
- 请确保网络连接畅通无阻，以免出现超时等问题。
- 可能需要根据实际情况调整超时时间（CURLOPT_TIMEOUT）以及其他cURL设置。
- 在实际应用中，建议对API返回的数据进行进一步处理和解析，以便于后续的业务逻辑处理。
#### 六、结语
通过以上内容，我们不仅了解了如何使用PHP语言调用APISpace的“IP归属地”API接口，还学习了调用API所需的基本步骤和注意事项。这对于需要进行IP归属地查询的开发者来说是非常实用的。希望本篇内容能够帮助大家更好地理解和使用APISpace所提供的服务。
