POST公开网络IP风控vv1

IP 地址解析

解析 IP 地址的协议版本、网络类型与内网属性,可用于风控前置判断与日志分析。

/v1/gateway/ip.inspect
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

解析 IP 地址的协议版本、网络类型与内网属性,可用于风控前置判断与日志分析。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
ipstring要解析的 IP;省略时使用调用方来源 IP

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

字段类型说明
ip*string
range*stringipaddr.js 的网络类型:unicast/private/loopback...
valid*boolean
version*union
isPrivate*boolean
isLoopback*boolean

请求示例

request.json
{
  "ip": "8.8.8.8"
}

返回示例

response.json
{
  "ip": "8.8.8.8",
  "range": "unicast",
  "valid": true,
  "version": 4,
  "isPrivate": false,
  "isLoopback": false
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →