API 文档

通过 JWT 认证访问我们的 IP 地理位置查询 API

认证

API 域名: api.ip-query.com

认证方式: JWT JWT 令牌

API 密钥分配: 使用 GitHub OAuth2 登录获取

撤销令牌

撤销API令牌以禁用其访问权限。

curl -X DELETE https://api.ip-query.com/api/revoke-token \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "X-Revoke-Token: TOKEN_TO_REVOKE"

API 端点

GET /api/lookup/:ip

获取指定 IP 地址的地理位置信息

参数:
  • ip (必需) - 要查询的 IP 地址（支持 IPv4 和 IPv6）
  • Authorization (必需) - 通过 GitHub OAuth2 获取的 JWT 令牌
使用示例:
curl -X GET https://api.ip-query.com/api/lookup/8.8.8.8 \ -H "Authorization: Bearer YOUR_JWT_TOKEN"
响应示例:
{ "ip": "8.8.8.8", "country": "United States", "country_code": "US", "region": "California", "city": "Mountain View", "isp": "Google LLC", "latitude": 37.4056, "longitude": -122.0775, "timezone": "America/Los_Angeles", "zip": "94043" }

GET /api/status

获取 API 服务状态和健康检查

参数:
  • Authorization (必需) - 通过 GitHub OAuth2 获取的 JWT 令牌
使用示例:
curl -X GET https://api.ip-query.com/api/status \ -H "Authorization: Bearer YOUR_JWT_TOKEN"

GET /api/myip

获取您自己的 IP 地址的地理位置信息

参数:
  • Authorization (必需) - 通过 GitHub OAuth2 获取的 JWT 令牌
使用示例:
curl -X GET https://api.ip-query.com/api/myip \ -H "Authorization: Bearer YOUR_JWT_TOKEN"

速率限制