调用地址
无需鉴权
支持 CORS
每 IP 每分钟 120 次
在线调试
请求会发送到本站接口当前请求：https://api.blueworkshop.top/api/v1/ip
请求参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
ip |
string | - | 要查询的 IP 地址；留空则返回调用方自己的公网 IP。 示例： 8.8.8.8 |
reverse |
bool | false |
是否尝试反向 DNS 解析（PTR）。 示例： false |
请求示例
cURL
curl "https://api.blueworkshop.top/api/v1/ip?ip=8.8.8.8&reverse=false"
JavaScript
const res = await fetch("https://api.blueworkshop.top/api/v1/ip?ip=8.8.8.8&reverse=false");
const data = await res.json();
console.log(data);响应示例
{
"ok": true,
"data": {
"ip": "8.8.8.8",
"version": 4,
"loopback": false,
"private": false,
"multicast": false,
"reverse": "dns.google"
},
"meta": {
"endpoint": "ip",
"cached": false
}
}
成功时返回 JSON 信封：ok 表示是否成功，data 为数据，meta.cached 表示是否命中本站缓存。图片类接口直接返回二进制图片。
错误响应
| HTTP | 错误码 | 说明 |
|---|---|---|
| 400 | missing_param / invalid_param | 缺少参数或参数格式不正确，响应会带上出错参数名。 |
| 404 | not_found | 接口不存在，或上游没有找到对应资源。 |
| 405 | method_not_allowed | 请求方法与接口要求不一致。 |
| 429 | rate_limited | 请求过于频繁，响应头 Retry-After 给出建议等待秒数。 |
| 502 | upstream_error / upstream_rate_limited | 上游服务异常或触发限流。 |
| 504 | timeout | 上游请求超时。 |
接口说明
不依赖任何外部服务，直接返回请求来源 IP 的基础信息。也可以传入 ip 参数查询指定地址的类型与反向解析结果。
本接口不会记录或返回 Cookie、Authorization 等敏感请求头，适合在调试网络、客户端环境识别时使用。