数据接口

想在自己的脚本、网页或面板里显示“我现在从哪里上网”?可以直接调这个接口。不用注册,不用密钥。

查询自己的 IP /v1/info

GEThttps://ip.mintryu.com/v1/info

返回发起请求的那一方的出口 IP 信息,没有参数,不能查别人的 IP。响应是 UTF-8 的 JSON,带 access-control-allow-origin: *,网页前端可以直接跨域调用。

命令行
curl https://ip.mintryu.com/v1/info
浏览器里的 JavaScript
const res = await fetch('https://ip.mintryu.com/v1/info');
const info = await res.json();
console.log(info.ip, info.country, info.fraudScore);

返回字段 fields

某项查不到时为 null。经纬度按字符串返回,和常见的同类接口保持一致。

字段类型含义
ipstring你的出口 IP,IPv4 或 IPv6
asnnumber自治系统号,例如 13335
asOrganizationstring这个 ASN 所属的组织或运营商名称
countrystring国家或地区名(英文)
countryCodestringISO 3166-1 两位代码,例如 US、JP
regionstring省、州一级的地区名
regionCodestring地区代码,例如 CA
citystring城市
timezonestringIANA 时区名,例如 Asia/Tokyo
longitudestring经度(字符串形式的小数)
latitudestring纬度(字符串形式的小数)
postalCodestring邮政编码,很多地区没有
fraudScorenumber本站估算的风险分,0 到 100,越低越干净
isResidentialboolean是否判断为住宅宽带 IP
isBroadcastboolean是否为广播 IP,即注册地和实际使用地不一致
userAgentstring服务器收到的 User-Agent 请求头
返回示例(地址为文档专用的示例地址)
{
  "ip": "203.0.113.7",
  "asn": 13335,
  "asOrganization": "Cloudflare, Inc.",
  "country": "United States",
  "countryCode": "US",
  "region": "California",
  "regionCode": "CA",
  "city": "Los Angeles",
  "timezone": "America/Los_Angeles",
  "longitude": "-118.24368",
  "latitude": "34.05223",
  "postalCode": "90012",
  "fraudScore": 12,
  "isResidential": true,
  "isBroadcast": false,
  "userAgent": "curl/8.9.1"
}

试一下 live

点按钮,会用你现在的连接真实请求一次。

另一个接口:信息卡片

GET https://ip.mintryu.com/v1/card 返回一张 600 × 300 的 SVG 图片,画的是请求者自己的 IP 信息,可以当作签名档或博客挂件。贴法见 访客 IP 信息卡片。

使用须知