POSTPublicip-portraint

IP Address Risk Profiling

Provides an IP address risk profiling API service, enabling developers to quickly access IP risk profile information and integrate it into business systems.

Documentation

IP Address Risk Profiling API Overview

The IP Address Risk Profiling API helps developers quickly process IP risk assessments within their systems. It returns structured results and is ideal for scenarios such as cybersecurity analysis, access risk control, and data governance.

Use Cases

Integrate IP address risk profiling capabilities into internal systems, SaaS platforms, automated workflows, or admin dashboards.
Suitable for business scenarios requiring stable API calls, standardized responses, and orchestratable interface capabilities.
We recommend combining this with rate limiting, failure retry mechanisms, and result caching strategies to improve overall integration stability.

Integration Recommendations

Verify request parameter formats, authentication methods, and error code handling logic before integration.
For high-frequency calling scenarios, it is recommended to implement log tracking, timeout control, and idempotency handling.
If the results are used for risk control or automated decision-making, we advise incorporating secondary evaluations based on your business rules rather than relying solely on the API response.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{}

Response Example

{
  "code": 200,
  "data": {
    "isp": {
      "type": "string",
      "example": "中国联通",
      "description": "运营商"
    },
    "lat": {
      "type": "string",
      "example": "30.267769",
      "description": "纬度"
    },
    "lng": {
      "type": "string",
      "example": "120.069641",
      "description": "经度"
    },
    "tag": {
      "type": "string",
      "example": "Sec_Dial",
      "description": "风险标签 1.Proxy (该IP被捕获到被当做代理IP来使用) 2.IDC Sec_Dial (该IP被捕获到被当做秒拨IP来使用) 3. (该IP被识别为数据中心机房IP) 4. VPN (该IP被捕获到被当做VPN IP来使用) 5. Tor (该IP被捕获到被当做Tor节点来使用) 6.Scan (该IP被捕获到有端口扫描行为) 7.Brute_Force (该IP被捕获到有暴力破解行为)"
    },
    "city": {
      "type": "string",
      "example": "杭州市",
      "description": "城市"
    },
    "prov": {
      "type": "string",
      "example": "浙江省",
      "description": "省份"
    },
    "level": {
      "type": "string",
      "example": "无",
      "description": "风险等级（存在多项值，参考风险标签与等级说明）"
    },
    "owner": {
      "type": "string",
      "example": "中国联通",
      "description": "所属机构"
    },
    "scene": {
      "type": "string",
      "example": "家庭宽带",
      "description": "使用场景"
    },
    "score": {
      "type": "number",
      "example": 0,
      "description": "风险分值"
    },
    "radius": {
      "type": "string",
      "example": "8.0562",
      "description": "定位半径"
    },
    "country": {
      "type": "string",
      "example": "中国",
      "description": "国家"
    },
    "areacode": {
      "type": "string",
      "example": "CN",
      "description": "国家编码"
    },
    "district": {
      "type": "string",
      "example": "西湖区",
      "description": "区县"
    },
    "continent": {
      "type": "string",
      "example": "亚洲",
      "description": "大洲"
    },
    "updatetime": {
      "type": "string",
      "example": "2024-06-24 18:03:36",
      "description": "风险捕获时间"
    }
  },
  "message": "success"
}

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	number	200
data	object	{...}
data.isp	object	{...}
data.isp.type	string	string
data.isp.example	string	中国联通
data.isp.description	string	运营商
data.lat	object	{...}

IP Address Risk Profiling

Documentation