终极echoip API参考手册：完整端点详解与实战示例

终极echoip API参考手册：完整端点详解与实战示例

【免费下载链接】echoipA simple IP address lookup service.项目地址: https://gitcode.com/gh_mirrors/ec/echoip

echoip是一个简单但功能强大的IP地址查询服务，能够快速获取IP地址的地理位置、ASN信息等关键数据。本文将详细介绍echoip的所有API端点，帮助开发者轻松集成这一实用工具到自己的项目中。

快速开始：如何获取IP信息

要开始使用echoip API，你只需向服务发送HTTP请求。最基础的API端点可以直接返回客户端的IP地址，无需复杂参数。

基础IP查询

使用以下命令可以快速获取当前公网IP：

curl https://echoip.example.com

或者访问以下URL：

https://echoip.example.com/ip

这将返回纯文本格式的IP地址，适合在命令行或脚本中使用。

核心API端点详解

echoip提供了多个API端点，满足不同的查询需求。以下是主要端点的详细说明：

1. 获取JSON格式的完整IP信息

端点：/json

方法：GET

描述：返回包含IP地址、地理位置、ASN等详细信息的JSON对象。

响应示例：

{ "ip": "192.168.1.1", "ip_decimal": 3232235777, "country": "United States", "country_iso": "US", "country_eu": false, "region_name": "California", "region_code": "CA", "city": "San Francisco", "latitude": 37.7749, "longitude": -122.4194, "time_zone": "America/Los_Angeles", "asn": "AS15169", "asn_org": "Google LLC", "hostname": "example.com" }

2. 获取国家信息

端点：/country

方法：GET

描述：返回IP地址所属国家的名称。

响应示例：

United States

3. 获取国家ISO代码

端点：/country-iso

方法：GET

描述：返回IP地址所属国家的ISO 3166-1 alpha-2代码。

响应示例：

US

4. 获取城市信息

端点：/city

方法：GET

描述：返回IP地址所属城市的名称。

响应示例：

San Francisco

5. 获取经纬度坐标

端点：/coordinates

方法：GET

描述：返回IP地址的经纬度坐标，格式为"纬度,经度"。

响应示例：

37.7749,-122.4194

6. 获取ASN信息

端点：/asn

方法：GET

描述：返回IP地址所属的自治系统编号（ASN）。

响应示例：

AS15169

7. 获取ASN组织信息

端点：/asn-org

方法：GET

描述：返回IP地址所属ASN的组织名称。

响应示例：

Google LLC

8. 端口测试

端点：/port/{port}

方法：GET

描述：测试指定端口是否可达，返回JSON格式的结果。

响应示例：

{ "ip": "192.168.1.1", "port": 80, "reachable": true }

高级使用技巧

1. 显式指定IP查询

你可以通过URL参数显式指定要查询的IP地址，例如：

https://echoip.example.com/json?ip=8.8.8.8

这将返回8.8.8.8的详细信息，而不是客户端的IP地址。

2. 健康检查

端点：/health

方法：GET

描述：检查服务是否正常运行，返回JSON格式的状态信息。

响应示例：

{"status":"OK"}

3. 缓存管理（调试功能）

端点：/debug/cache/

方法：GET

描述：返回缓存统计信息，包括大小、容量和驱逐次数。

响应示例：

{ "size": 100, "capacity": 1000, "evictions": 5 }

如何部署echoip服务

要在自己的服务器上部署echoip服务，请按照以下步骤操作：

1. 克隆仓库：

git clone https://gitcode.com/gh_mirrors/ec/echoip

2. 进入项目目录：

cd echoip

3. 构建项目：

make build

4. 运行服务：

./echoip

默认情况下，服务将在端口8080上运行。你可以通过命令行参数自定义端口和其他设置。

常见问题解答

Q: echoip支持IPv6吗？

A: 是的，echoip完全支持IPv4和IPv6地址查询。

Q: 如何在我的应用中集成echoip API？

A: 你可以通过简单的HTTP请求调用echoip API，然后解析返回的JSON或文本响应。具体实现取决于你使用的编程语言和框架。

Q: echoip的数据源是什么？

A: echoip使用IP地理数据库来提供地理位置信息，具体实现可参考iputil/geo/geo.go。

总结

echoip提供了一系列简单易用的API端点，让开发者能够轻松获取IP地址的各种信息。无论是构建网络诊断工具、个性化内容推荐，还是增强安全措施，echoip都是一个理想的选择。通过本文介绍的端点和使用技巧，你可以快速将echoip集成到自己的项目中，为用户提供更丰富的功能和更好的体验。

【免费下载链接】echoipA simple IP address lookup service.项目地址: https://gitcode.com/gh_mirrors/ec/echoip