005 平台 API 接口文档

# API 接口说明文档

## 概述

本文档描述了两个核心 API 接口的详细信息：
- `download_fingerprint_rules` - 下载指纹规则库
- `download_poc_by_name` - 根据名称下载 POC 文件

---

## 1. download_fingerprint_rules

### 接口信息

| 项目 | 说明 |
|------|------|
| **路径** | `/api/download_fingerprint_rules/` |
| **方法** | `GET` |
| **认证** | 需要 Token（已激活用户） |
| **描述** | 获取系统中所有指纹规则，用于资产识别和漏洞检测 |

### 请求参数

无请求参数

### 返回格式

```json
{
    "status": true,
    "timestamp": 1717996800,
    "system_rules": {
        "1": {
            "rules": [...],
            "name": "指纹名称",
            "info": "指纹简介",
            "poc": ["poc_name_1", "poc_name_2"]
        }
    }
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `status` | boolean | 操作是否成功 |
| `timestamp` | integer | 响应时间戳（秒） |
| `system_rules` | object | 指纹规则对象，key 为指纹ID |
| `system_rules[*].rules` | array | Base64解码后的规则列表 |
| `system_rules[*].name` | string | 指纹名称 |
| `system_rules[*].info` | string | 指纹简介 |
| `system_rules[*].poc` | array | 关联的POC名称列表 |

### 示例

**请求：**
```bash
GET /api/download_fingerprint_rules/
```

**响应：**
```json
{
    "status": true,
    "timestamp": 1717996800,
    "system_rules": {
        "1": {
            "rules": [
                {
                    "method": "GET",
                    "path": "/robots.txt",
                    "keyword": "Disallow"
                }
            ],
            "name": "通用指纹",
            "info": "基础指纹规则",
            "poc": ["CVE-2024-0001", "CVE-2024-0002"]
        }
    }
}
```

**真实样例数据（实测返回）：**
```json
{
    "status": true,
    "timestamp": 1786979045,
    "system_rules": {
        "1": {
            "rules": [
                [{"match": "body_contains", "content": "name=\"generator\" content=\"wordpress "}],
                [{"match": "header_contains", "content": "x-pingback"}],
                [{"match": "header_contains", "content": "/xmlrpc.php"}],
                [{"match": "body_contains", "content": "/wp-includes/"}],
                [{"match": "header_contains", "content": "wordpress_test_cookie"}],
                [{"match": "header_contains", "content": "WordPress"}]
            ],
            "system_name": "wordpress",
            "system_info": "知名博客系统",
            "pocs": [
                "b85e780aab894c80b81a96a6071f5fec",
                "492e0a1460274952b4298e8c66d5f470",
                "d7c5f4479b024a70941fe99fbfa199f3",
                "df92cb42a264451ea48fb0202785647c",
                "6551313c854548db9276878930839728",
                "65b7c62a4b2e42e7ac6e026749526763",
                "5006a5c5bbe545acab3cc4c6defd5619"
            ]
        },
        "2": {
            "rules": [
                [{"match": "body_contains", "content": "/wp-content/plugins/extensive-vc-addon"}]
            ],
            "system_name": "wp-extensive-vc-addon",
            "system_info": "wp-extensive-vc-addon",
            "pocs": ["29d4efa3ac1249da8ef34d1411047262"]
        }
    }
}
```
> 说明：规则结构为 `[[规则对象], ...]`，`match` 取值如 `body_contains` / `header_contains`，`content` 为匹配关键字。

---

## 2. download_poc_by_name

### 接口信息

| 项目 | 说明 |
|------|------|
| **路径** | `/api/download_poc_by_name/` |
| **方法** | `POST` |
| **认证** | Token 认证（Header: `Authorization: Token <token>`） |
| **描述** | 根据 POC 名称购买并下载 POC 文件，首次下载消耗 10 金币 |

### 请求参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `poc_name` | string | 是 | POC 文件名称 |

### 请求示例

```bash
POST /api/download_poc_by_name/
Content-Type: application/json
Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b

{
    "poc_name": "CVE-2024-0001"
}
```

### 返回格式

**成功响应（首次下载）：**
```json
{
    "success": true,
    "message": "购买并下载POC成功: CVE-2024-0001",
    "data": {
        "poc_name": "CVE-2024-0001",
        "content": "...POC内容...",
        "downloaded_before": false,
        "cost": 10,
        "remaining_coins": 990
    }
}
```

**成功响应（已下载过）：**
```json
{
    "success": true,
    "message": "已成功获取POC: CVE-2024-0001",
    "data": {
        "poc_name": "CVE-2024-0001",
        "content": "...POC内容...",
        "downloaded_before": true
    }
}
```

**失败响应：**
```json
{
    "success": false,
    "message": "错误描述信息"
}
```

### 真实样例数据（实测返回）

> 说明：当前实际接口路径为 `/api/download_poc/`，请求参数为 `poc_uuid`（POC 唯一标识）。

```json
{
    "success": true,
    "message": "用户 \"admin\" 购买并下载POC: CVE-2017-5487",
    "data": {
        "poc_uuid": "b85e780aab894c80b81a96a6071f5fec",
        "poc_name": "CVE-2017-5487",
        "content": "id: CVE-2017-5487\n\ninfo:\n  name: WordPress Core <4.7.1 - Username Enumeration\n  author: Manas_Harsh,daffainfo,geeknik,dr0pd34d\n  severity: medium\n  description: WordPress Core before 4.7.1 is susceptible to user enumeration because it does not properly restrict listings of post authors via wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php in the REST API, which allows a remote attacker to obtain sensitive information via a wp-json/wp/v2/users request.\n  remediation: |\n    Update WordPress to version 4.7.1 or later\n  reference:\n    - https://www.exploit-db.com/exploits/41497\n    - https://www.wordfence.com/blog/2016/12/wordfence-blocks-username-harvesting-via-new-rest-api-wp-4-7/\n  classification:\n    cvss-metrics: CVSS:3.0/AV:N/AC:L/PR:N/UI:N/S:U/C:L/I:N/A:N\n    cvss-score: 5.3"
    }
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `success` | boolean | 操作是否成功 |
| `message` | string | 操作结果描述 |
| `data` | object | 返回数据（成功时） |
| `data.poc_name` | string | POC 名称 |
| `data.content` | string | POC 文件内容 |
| `data.downloaded_before` | boolean | 是否已下载过 |
| `data.cost` | integer | 消耗金币数（仅首次下载） |
| `data.remaining_coins` | integer | 剩余金币数（仅首次下载） |

### 错误码说明

| HTTP 状态码 | 错误信息 | 说明 |
|------------|----------|------|
| 400 | 缺少必填参数：poc_name | 请求缺少 poc_name 参数 |
| 400 | POC名称不能为空 | poc_name 参数为空 |
| 400 | 金币不足，需要 10 金币，当前 X 金币 | 用户金币余额不足 |
| 401 | 用户未登录 | Token 无效或未提供 |
| 404 | POC "xxx" 不存在 | 指定的 POC 不存在 |
| 404 | POC文件未找到 | POC 文件在服务器上不存在 |
| 500 | 处理请求时出错：xxx | 服务器内部错误 |

---

## 认证方式

### Token 获取

```bash
POST /api-token-auth/
Content-Type: application/json

{
    "username": "your_username",
    "password": "your_password"
}
```

### 响应示例

```json
{
    "token": "9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b"
}
```

---

## 使用示例

### Python 调用示例

```python
import requests

BASE_URL = "http://localhost:8000"

# 1. 获取指纹规则（需要 Token 认证）
headers = {"Authorization": "Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b"}
response = requests.get(f"{BASE_URL}/api/download_fingerprint_rules/", headers=headers)
print("指纹规则:", response.json())

# 2. 登录获取 Token
login_response = requests.post(
    f"{BASE_URL}/api-token-auth/",
    data={"username": "user", "password": "pass"}
)
token = login_response.json()["token"]

# 3. 下载 POC（需要认证）
headers = {"Authorization": f"Token {token}"}
poc_response = requests.post(
    f"{BASE_URL}/api/download_poc_by_name/",
    headers=headers,
    json={"poc_name": "CVE-2024-0001"}
)
print("POC下载结果:", poc_response.json())
```

---

## 注意事项

1. **Token 有效期**：Token 长期有效，建议妥善保管
2. **金币消耗**：每个 POC 首次下载消耗 10 金币，重复下载不消耗
3. **错误处理**：请根据 HTTP 状态码和返回的 message 字段处理异常情况

---

# 用户资产查询 API 接口文档

## 概述

以下 5 个 API 面向普通用户（已激活账号），均需要提供 **Token** 进行认证：

| # | 接口 | 方法 | 说明 |
|---|------|------|------|
| 1 | `query_domain_history_ips` | GET | 基于域名查询历史解析 IP，寻找云防护背后真实 IP |
| 2 | `get_unlocked_websites` | GET | 获取已解锁项目下的所有网站资产 |
| 3 | `get_unlocked_subdomains` | GET | 获取已解锁项目下的所有子域名 |
| 4 | `get_unlocked_domains` | GET | 获取已解锁项目下的所有主域名 |
| 5 | `get_unlocked_ips` | GET | 获取已解锁项目下的所有关联 IP（含端口信息） |

### 通用认证方式

所有请求需携带请求头：

```
Authorization: Token <用户Token>
```

- **Token 获取方式**：通过 `/api-token-auth/` 登录接口获取
- **激活要求**：只有已激活（`is_active=True`）的用户 Token 才有效，未激活用户的 Token 认证会返回 `401 Unauthorized`
- **未携带 Token**：返回 `401 Unauthorized`

### 通用返回结构

```json
{
    "success": true,
    "message": "操作结果消息",
    "data": { ... },
    "pagination": { ... }   // 部分接口有
}
```

### 通用错误码

| HTTP 状态码 | 含义 |
|-------------|------|
| `401` | 未认证或 Token 无效（未激活用户） |
| `400` | 缺少必填参数或参数格式错误 |
| `404` | 查询的数据不存在 |
| `500` | 服务器内部错误 |

---

## 1. 基于域名查询历史解析 IP

### 接口信息

| 项目 | 说明 |
|------|------|
| **路径** | `/api/query_domain_history_ips/` |
| **方法** | `GET` |
| **认证** | 需要 Token（已激活用户） |
| **描述** | 基于主域名查询其历史解析的所有 IP，IP 类型可帮助识别云 WAF/CDN 背后的真实 IP，方便自动化测试 |

### 请求参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `domain` | string | 是 | 主域名，如 `example.com` |

### 请求示例

```bash
curl -H "Authorization: Token <TOKEN>" \
  "http://localhost:8000/api/query_domain_history_ips/?domain=example.com"
```

### 响应示例

```json
{
    "success": true,
    "message": "查询成功，共找到 2 个关联IP",
    "data": {
        "domain": "example.com",
        "ownership": 1,
        "ownership_text": "公益权重",
        "valid_status": 1,
        "valid_text": "有解析",
        "ips": [
            {
                "ip_address": "1.2.3.4",
                "ip_type": 1,
                "ip_type_text": "云WAF"
            },
            {
                "ip_address": "5.6.7.8",
                "ip_type": 0,
                "ip_type_text": "国内IP"
            }
        ],
        "ip_count": 2
    }
}
```

### 真实样例数据（实测返回）

```json
{
    "success": true,
    "message": "查询成功，共找到 3 个关联IP",
    "data": {
        "domain": "krbb.cn",
        "ownership": 0,
        "ownership_text": "未知",
        "valid_status": 0,
        "valid_text": "未知",
        "ips": [
            {
                "ip_address": "219.128.252.150",
                "ip_type": 0,
                "ip_type_text": "国内IP"
            },
            {
                "ip_address": "121.9.250.34",
                "ip_type": 0,
                "ip_type_text": "国内IP"
            },
            {
                "ip_address": "121.9.250.32",
                "ip_type": 0,
                "ip_type_text": "国内IP"
            }
        ],
        "ip_count": 3
    }
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `data.domain` | string | 查询的主域名 |
| `data.ownership` | integer | 归属标志：0-未知，1-公益权重，2-国内备案，3-无备案或归属个人 |
| `data.valid_status` | integer | 有效标志：0-未知，1-有解析，2-泛解析，3-无解析 |
| `data.ips[].ip_address` | string | 历史解析的 IP 地址 |
| `data.ips[].ip_type` | integer | IP 类型：0-国内IP，1-云WAF，2-云CDN，3-云SaaS |
| `data.ips[].ip_type_text` | string | IP 类型中文说明 |
| `data.ip_count` | integer | 关联 IP 总数 |

> **说明**：`ip_type` 为 1（云WAF）/2（云CDN）的 IP 通常为云防护节点，其余类型 IP 可能是目标真实 IP，可用于绕过云防护的自动化测试。

---

## 2. 获取已解锁项目下的所有网站资产

### 接口信息

| 项目 | 说明 |
|------|------|
| **路径** | `/api/get_unlocked_websites/` |
| **方法** | `GET` |
| **认证** | 需要 Token（已激活用户） |
| **描述** | 返回当前用户所有已解锁且在有效期内的项目下的网站资产（仅限已解锁项目，未解锁项目数据不可见） |

### 请求参数（可选）

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | integer | 否 | 1 | 页码 |
| `page_size` | integer | 否 | 100 | 每页数量，范围 1-500 |

### 请求示例

```bash
curl -H "Authorization: Token <TOKEN>" \
  "http://localhost:8000/api/get_unlocked_websites/?page=1&page_size=50"
```

### 响应示例

```json
{
    "success": true,
    "message": "获取成功，共 3 条网站资产",
    "data": [
        {
            "id": 1,
            "url": "http://www.example.com",
            "website_type": 0,
            "status": 0,
            "response_code": 200,
            "is_generic_system": false,
            "ownership_type": 0,
            "is_directory_scanned": false,
            "subdomain": "www.example.com",
            "ip_address": "1.2.3.4",
            "src_name": "某SRC项目",
            "title": "Example 官网",
            "created_at": "2026-06-29 10:00:00"
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 50,
        "total": 3,
        "total_pages": 1
    }
}
```

### 真实样例数据（实测返回）

```json
{
    "success": true,
    "message": "获取成功，共 5516 条网站资产",
    "data": [
        {
            "id": 3775,
            "url": "https://ir.lexin.com",
            "website_type": 0,
            "status": 2,
            "response_code": 200,
            "is_generic_system": true,
            "ownership_type": 0,
            "is_directory_scanned": false,
            "subdomain": "ir.lexin.com",
            "ip_address": null,
            "src_name": "乐信集团",
            "title": "Overview | LexinFintech",
            "created_at": "2026-01-27 15:11:44"
        },
        {
            "id": 3796,
            "url": "https://pss-ccp-dmzwebcontent-wgq-padis-dmzstg2.pingan.com.cn",
            "website_type": 0,
            "status": 2,
            "response_code": 200,
            "is_generic_system": false,
            "ownership_type": 0,
            "is_directory_scanned": false,
            "subdomain": "pss-ccp-dmzwebcontent-wgq-padis-dmzstg2.pingan.com.cn",
            "ip_address": null,
            "src_name": "平安安全应急响应中心",
            "title": "DNS resolution error | pss-ccp-dmzwebcontent-wgq-padis-dmzstg2.pingan.com.cn | Cloudflare",
            "created_at": "2026-01-27 15:13:52"
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 2,
        "total": 5516,
        "total_pages": 2758
    }
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `data[].url` | string | 网站 URL |
| `data[].website_type` | integer | 网站类型：0-域名网站，1-IP网站，2-组合网站 |
| `data[].status` | integer | 网站标志位 |
| `data[].response_code` | integer | HTTP 响应状态码 |
| `data[].is_generic_system` | boolean | 是否为通用系统 |
| `data[].ownership_type` | integer | 归属方式：0-主域名归属，1-子域名白名单，2-IP备案，3-IP证书域名，4-IP解析子域，5-IP段扩展 |
| `data[].subdomain` | string/null | 关联子域名 |
| `data[].ip_address` | string/null | 关联 IP 地址 |
| `data[].src_name` | string/null | 所属 SRC 项目名称 |
| `data[].title` | string | 网站最新标题 |
| `data[].created_at` | string | 创建时间 |

---

## 3. 获取已解锁项目下的所有子域名

### 接口信息

| 项目 | 说明 |
|------|------|
| **路径** | `/api/get_unlocked_subdomains/` |
| **方法** | `GET` |
| **认证** | 需要 Token（已激活用户） |
| **描述** | 返回当前用户所有已解锁项目下的子域名信息 |

### 请求参数（可选）

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | integer | 否 | 1 | 页码 |
| `page_size` | integer | 否 | 100 | 每页数量，范围 1-500 |

### 请求示例

```bash
curl -H "Authorization: Token <TOKEN>" \
  "http://localhost:8000/api/get_unlocked_subdomains/?page=1&page_size=100"
```

### 响应示例

```json
{
    "success": true,
    "message": "获取成功，共 2 条子域名",
    "data": [
        {
            "id": 10,
            "subdomain_name": "www.example.com",
            "domain": "example.com",
            "src_name": "某SRC项目",
            "ip_address": "1.2.3.4",
            "cname": "cdn.example-cdn.com",
            "is_new": false,
            "status": true,
            "created_at": "2026-06-01 09:00:00"
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 100,
        "total": 2,
        "total_pages": 1
    }
}
```

### 真实样例数据（实测返回）

```json
{
    "success": true,
    "message": "获取成功，共 2536 条子域名",
    "data": [
        {
            "id": 15597,
            "subdomain_name": "ntp.fenqile.cn",
            "domain": "fenqile.cn",
            "src_name": "乐信集团",
            "ip_address": "10.11.52.134",
            "cname": null,
            "is_new": true,
            "status": false,
            "created_at": "2026-01-08 19:54:27"
        },
        {
            "id": 15598,
            "subdomain_name": "nexus.fenqile.cn",
            "domain": "fenqile.cn",
            "src_name": "乐信集团",
            "ip_address": "10.11.13.99",
            "cname": "fql.kibana.fenqile.cn",
            "is_new": true,
            "status": false,
            "created_at": "2026-01-08 19:54:27"
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 2,
        "total": 2536,
        "total_pages": 1268
    }
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `data[].subdomain_name` | string | 子域名 |
| `data[].domain` | string | 所属主域名 |
| `data[].src_name` | string/null | 所属 SRC 项目名称 |
| `data[].ip_address` | string/null | 解析的 IP 地址 |
| `data[].cname` | string/null | CNAME 记录 |
| `data[].is_new` | boolean | 是否为新增 |
| `data[].status` | boolean | 状态 |

---

## 4. 获取已解锁项目下的所有主域名

### 接口信息

| 项目 | 说明 |
|------|------|
| **路径** | `/api/get_unlocked_domains/` |
| **方法** | `GET` |
| **认证** | 需要 Token（已激活用户） |
| **描述** | 返回当前用户所有已解锁项目下的主域名信息 |

### 请求参数（可选）

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | integer | 否 | 1 | 页码 |
| `page_size` | integer | 否 | 100 | 每页数量，范围 1-500 |

### 请求示例

```bash
curl -H "Authorization: Token <TOKEN>" \
  "http://localhost:8000/api/get_unlocked_domains/?page=1&page_size=100"
```

### 响应示例

```json
{
    "success": true,
    "message": "获取成功，共 1 条主域名",
    "data": [
        {
            "id": 5,
            "domain": "example.com",
            "src_name": "某SRC项目",
            "status": 1,
            "status_text": "正常",
            "is_wildcard": false,
            "registrant": "张三",
            "expiry_date": "2027-12-31",
            "created_at": "2026-01-01 00:00:00"
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 100,
        "total": 1,
        "total_pages": 1
    }
}
```

### 真实样例数据（实测返回）

```json
{
    "success": true,
    "message": "获取成功，共 173 条主域名",
    "data": [
        {
            "id": 4467,
            "domain": "fenqile.cn",
            "src_name": "乐信集团",
            "status": 1,
            "status_text": "正常",
            "is_wildcard": false,
            "registrant": "yunwei@lexin.com",
            "expiry_date": "2027-04-11",
            "created_at": "2025-11-17 09:21:54"
        },
        {
            "id": 4468,
            "domain": "fenqile.com",
            "src_name": "乐信集团",
            "status": 1,
            "status_text": "正常",
            "is_wildcard": false,
            "registrant": "DomainAbuse@service.aliyun.com",
            "expiry_date": "2027-04-11",
            "created_at": "2025-11-17 09:21:54"
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 2,
        "total": 173,
        "total_pages": 87
    }
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `data[].domain` | string | 主域名 |
| `data[].src_name` | string/null | 所属 SRC 项目名称 |
| `data[].status` | integer | 状态：0-新增，1-正常，2-失效，3-第三方，4-限定域名 |
| `data[].status_text` | string | 状态中文说明 |
| `data[].is_wildcard` | boolean | 是否泛解析 |
| `data[].registrant` | string/null | 注册人 |
| `data[].expiry_date` | string/null | 注册有效期 |
| `data[].created_at` | string | 创建时间 |

---

## 5. 获取已解锁项目下的所有关联 IP（含端口信息）

### 接口信息

| 项目 | 说明 |
|------|------|
| **路径** | `/api/get_unlocked_ips/` |
| **方法** | `GET` |
| **认证** | 需要 Token（已激活用户） |
| **描述** | 返回当前用户所有已解锁项目下关联的 IP 资产信息，包含每个 IP 的端口扫描结果 |

### 请求参数（可选）

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | integer | 否 | 1 | 页码 |
| `page_size` | integer | 否 | 100 | 每页数量，范围 1-500 |

### 请求示例

```bash
curl -H "Authorization: Token <TOKEN>" \
  "http://localhost:8000/api/get_unlocked_ips/?page=1&page_size=100"
```

### 响应示例

```json
{
    "success": true,
    "message": "获取成功，共 1 条IP资产",
    "data": [
        {
            "id": 100,
            "ip_address": "1.2.3.4",
            "status": 2,
            "status_text": "目标IP",
            "is_ipv6": false,
            "certificate_info": "CN=example.com",
            "ports": [
                {
                    "port_number": 80,
                    "protocol": 0,
                    "protocol_text": "TCP",
                    "service": "http",
                    "fingerprint": "nginx/1.18.0",
                    "status": 0
                },
                {
                    "port_number": 443,
                    "protocol": 0,
                    "protocol_text": "TCP",
                    "service": "https",
                    "fingerprint": null,
                    "status": 0
                }
            ]
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 100,
        "total": 1,
        "total_pages": 1
    }
}
```

### 真实样例数据（实测返回）

```json
{
    "success": true,
    "message": "获取成功，共 3054 条IP资产",
    "data": [
        {
            "id": 729133,
            "ip_address": "103.80.27.19",
            "status": 2,
            "status_text": "目标IP",
            "is_ipv6": false,
            "certificate_info": null,
            "ports": [
                {
                    "port_number": 22,
                    "protocol": 0,
                    "protocol_text": "TCP",
                    "service": "ssh",
                    "fingerprint": "SSH-2.0-OpenSSH_7.4",
                    "status": 0
                }
            ]
        },
        {
            "id": 507980,
            "ip_address": "163.181.143.73",
            "status": 3,
            "status_text": "C段IP",
            "is_ipv6": false,
            "certificate_info": null,
            "ports": [
                {
                    "port_number": 8090,
                    "protocol": 0,
                    "protocol_text": "TCP",
                    "service": "http",
                    "fingerprint": "HTTP/1.1 400 Bad Request\r\nServer: Apache-Coyote/1.1",
                    "status": 1
                },
                {
                    "port_number": 10000,
                    "protocol": 2,
                    "protocol_text": "TCP/UDP",
                    "service": "websocket",
                    "fingerprint": "HTTP/1.1 426 Upgrade Required",
                    "status": 0
                }
            ]
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 2,
        "total": 3054,
        "total_pages": 1527
    }
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `data[].ip_address` | string | IP 地址 |
| `data[].status` | integer | IP 状态：0-内网IP，1-云IP，2-目标IP，3-C段IP |
| `data[].status_text` | string | IP 状态中文说明 |
| `data[].is_ipv6` | boolean | 是否 IPv6 |
| `data[].certificate_info` | string/null | 证书信息 |
| `data[].ports[]` | array | 端口扫描结果列表 |
| `data[].ports[].port_number` | integer/null | 端口号 |
| `data[].ports[].protocol` | integer | 协议：0-TCP，1-UDP，2-TCP/UDP |
| `data[].ports[].protocol_text` | string | 协议中文说明 |
| `data[].ports[].service` | string/null | 服务类型 |
| `data[].ports[].fingerprint` | string/null | 端口指纹信息 |
| `data[].ports[].status` | integer | 状态：0-新增，1-已处理 |

---

## 注意事项（用户资产查询 API）

1. **权限隔离**：接口 2-5 仅返回用户已解锁且在有效期内的项目资产，未解锁项目的数据不会返回
2. **解锁有效期**：项目解锁后一年内有效，过期后无法查询对应资产
3. **分页**：`page_size` 最大 500，超出自动截断；页码越界自动回退到第 1 页
4. **无解锁项目**：返回 `success: true` 且 `data` 为空数组
5. **Token 安全**：Token 等同于账号凭证，请勿泄露，建议通过 HTTPS 传输
6. **请求频率**：建议合理控制请求频率，避免频繁调用