视频解析服务 API 文档

接口概览

所有接口均通过 HTTP GET 请求进行调用,统一返回 JSON 格式数据。

1. 视频解析接口

提交视频链接,获取无水印视频地址。

GET/api/parse

请求参数

参数名 必选 类型 说明
url string 需要解析的视频链接或包含链接的分享文案
key string 用户授权密钥

成功响应示例

{
    "code": 200,
    "msg": "请求成功",
    "data": {
        "title": "视频标题内容...",
        "urls": "http://example.com/video.mp4,http://example.com/video2.mp4",
        "cover": "http://example.com/cover.jpg"
    }
}

失败响应示例

{
    "code": 4001,
    "msg": "视频不存在或解析失败",
    "data": ""
}

2. 日志查询接口

查询历史解析记录,支持时间范围筛选和分页。

GET/api/logs

请求参数

参数名 必选 类型 说明
key string 用户授权密钥
startDate string 开始时间 (格式: YYYY-MM-DD HH:mm:ss)
endDate string 结束时间 (格式: YYYY-MM-DD HH:mm:ss)
page number 页码 (默认: 1)
pageSize number 每页数量 (默认: 10)

响应示例

{
    "code": 200,
    "msg": "查询成功",
    "data": {
        "list": [
            {
                "id": 1,
                "original_url": "http://xhslink.com/...",
                "video_url": "http://example.com/video.mp4",
                "create_time": "2025-12-31 14:30:57",
                "status": 1,
                "request_ip": "127.0.0.1",
                "api": "xiazaigou"
            }
        ],
        "total": 100,
        "page": 1,
        "pageSize": 10
    }
}

附录: 错误码字典

状态码 说明
200请求成功
1001缺少 url 参数
1002缺少 key 参数
1003url 格式不正确
2001无效的用户密钥
2002用户密钥已过期
2004解析次数已达上限
3001数据库连接失败
4001视频不存在或解析失败
4002视频解析失败
5001系统内部错误
5003解析超时