跳转至

数据源API配置

数据源API功能将疯狂URL捕获到的URL数据实时同步到本地JSON文件，为第三方程序提供数据接口。

功能说明

数据源API将捕获的网络请求信息以JSON格式实时写入本地文件，供其他程序读取和处理。启用此功能后，疯狂URL会将所有捕获的URL数据同步到指定的JSON文件中。

配置步骤

1. 打开设置界面

  1. 启动疯狂URL 4软件
  2. 点击菜单栏的**设置**选项
  3. 在设置窗口中找到**数据源API**选项

2. 启用数据源API

  1. 勾选启用：勾选"启用数据源API"复选框
  2. 设置文件路径：指定JSON文件的保存位置
    • 示例路径：E:\temp\API
    • 可自定义为任意可写入的文件路径

  3. ***筛选条件** 可根据需求调整

    alt text

  4. 点击确定：保存配置并启用功能

  5. 验证 data.json文件是否生成： 打开E:\temp\API目录，查看是否生成data.json文件

JSON数据格式

基本数据结构

数据源API输出的是一个JSON数组，每个元素代表一个捕获的HTTP请求：

[
    {
        "Url": "https://example-live.com/live/stream_12345.flv?token=abc123&t=1234567890",
        "Host": "example-live.com",
        "Port": 443,
        "HttpVersion": "1.1",
        "Overview": null,
        "RequestHeaders": {
            "Host": "example-live.com",
            "Connection": "keep-alive",
            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36",
            "Accept": "*/*",
            "Origin": "https://www.example.com",
            "Referer": "https://www.example.com/",
            "Accept-Encoding": "gzip, deflate, br, identity"
        },
        "ResponseHeaders": {
            "Access-Control-Allow-Methods": "GET,POST,OPTIONS",
            "Access-Control-Allow-Origin": "*",
            "Cache-Control": "no-cache",
            "Connection": "close",
            "Content-Type": "video/x-flv",
            "Server": "Example Media Server",
            "Transfer-Encoding": "chunked"
        },
        "HeaderText": "",
        "RequestBody": "",
        "ResponseBody": "",
        "Protocol": "https",
        "Path": "/live/stream_12345.flv?token=abc123&t=1234567890",
        "Description": "",
        "Id": 1,
        "StatusCode": "200 OK",
        "ContentType": "video/x-flv",
        "Size": -1
    }
]

字段说明

主要字段

  • Url: 完整的URL地址
  • Host: 主机域名
  • Port: 端口号
  • HttpVersion: HTTP版本（如"1.1"）
  • Protocol: 网络协议（http/https）
  • Path: URL路径部分
  • Id: 唯一标识符（递增数字）
  • StatusCode: HTTP状态码（如"200 OK"）
  • ContentType: Content-Type响应类型
  • Size: 数据大小（字节，-1表示未知）

请求和响应信息

  • RequestHeaders: HTTP请求头信息（对象）
  • ResponseHeaders: HTTP响应头信息（对象）
  • RequestBody: 请求体内容
  • ResponseBody: 响应体内容
  • HeaderText: 原始头部文本

其他字段

  • Overview: 概览信息（通常为null）
  • Description: 描述信息（通常为空字符串）

使用验证

验证配置是否生效

  1. 启动捕获：启动任意捕获模式（网卡模式、代理模式等）
  2. 访问网站：访问一些包含媒体内容的网站
  3. 检查文件：查看指定路径下是否生成了data.json文件
  4. 查看内容：打开data.json文件确认是否包含捕获的URL数据

基本读取示例

# Python简单读取示例
import json

with open('data.json', 'r', encoding='utf-8') as f:
    data = json.load(f)

for item in data:
    print(f"URL: {item.get('Url', '')}")
    print(f"类型: {item.get('ContentType', '')}")

注意事项

  • 文件权限：确保疯狂URL有写入指定目录的权限
  • 磁盘空间：预留足够的磁盘空间存储数据文件
  • 数据隐私：API数据文件包含网络请求信息，注意保护隐私
  • 定期清理：建议定期清理过期的API数据文件

常见问题

文件未生成 - 检查数据源API是否已启用 - 确认文件路径是否有写入权限 - 重启疯狂URL软件

数据不更新 - 确认捕获模式已启动 - 检查是否有新的网络请求被捕获 - 验证过滤条件是否过于严格

文件无法读取 - 检查文件路径是否正确 - 确认JSON格式是否有效 - 验证文件是否被其他程序占用

相关链接