IP地址获取

GET
https://api.auth.top/api/getip
https://api.auth.top/api/getip

服务指标

QPS 上限
30次/秒
平均响应时间
2.17ms

接口描述

获取请求来源的IP地址，支持公网环境识别，为访问控制、用户定位与流量分析提供源端标识。

请求参数

怎么传递这个 Key？
推荐
方法 1：Bearer Token (Header)
标准规范，兼容性最好，最安全
Authorization:Bearer Key
方法 2：放在请求头 (Header)
直接使用 Authorization，无需前缀
Authorization:Key
方法 3：放在请求头 (Header)
自定义 Header key 字段
key:Key
不推荐
方法 4：放在网址后面 (Query)
不安全，可能泄露 Key，即将弃用
网址?key=Key

请求示例

Shell
JavaScript
Python
PHP
Java
Go
C#
Ruby
curl -X GET 'https://api.auth.top/api/getip?format=${json / xml / text / ip}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

返回示例

{
  "code": 0,
  "msg": "获取成功",
  "data": {
    "ip": "3.130.51.1",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.5845.97 Safari/537.36 Core/1.116.578.400 QQBrowser/19.8.6829.400",
    "request_method": "GET",
    "request_time": "2026-01-08 01:22:20"
  }
}