ip获取

接口说明

用于查询 IP 地址信息：传入指定 IP 时返回该地址，不传则返回调用方当前 IP。适合需要快速获取自身出口 IP 或校验某个 IP 的轻量场景，免费调用，无需密钥。

调用地址

https://mini10.top/api/ip

请求方式

GET

鉴权说明

无需密钥，可直接调用。

请求参数

参数取值说明：ip 为可选参数，留空即查询当前 IP；填写时传入待查询的 IP 地址字符串。

成功响应示例

{
"ret": 200,
"data": {
"ip": "127.0.0.1"
}
}

响应字段说明

错误响应示例

{
"code": 0,
"msg": "接口维护中",
"errcode": 11006
}

业务错误码说明

调用示例

终端 curl（bash）

curl "https://mini10.top/api/ip"

curl "https://mini10.top/api/ip?ip=127.0.0.1"

PHP

// 获取当前 IP
$ch = curl_init("https://mini10.top/api/ip");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

// 查询指定 IP
$ch = curl_init("https://mini10.top/api/ip?ip=" . urlencode("127.0.0.1"));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

注意事项

• 本接口无需密钥、免费调用，可直接请求，不存在密钥保管与泄露问题；请勿在请求中附加任何密钥类参数。
• 不传 ip 参数时，返回的是发起请求一方的当前 IP，结果与调用网络环境相关；如需固定结果，请显式传入 ip。
• 传入 ip 时建议对参数值做 URL 编码，避免特殊字符导致解析异常。
• 请使用 HTTPS 访问调用地址，保证请求与返回内容在传输过程中不被篡改。
• 接口存在频率限制（QPM），请勿高频轮询；如需定时获取 IP，建议适当加大间隔并对返回结果做本地缓存。
• 返回的 ip 字段为字符串，请按字符串处理，避免自行做数值转换导致格式异常。