对视频去水印下载解析接口进行全面解读。该接口采用标准HTTP GET请求方式，返回JSON格式数据，支持微信视频号、抖音、快手、小红书等主流短视频与图文平台链接解析。
接口核心能力：传入短视频 / 图集分享链接，解析出原始视频地址、封面图、作品标题、作者信息等结构化数据，适用于内容采集、自媒体工具、素材整理等后端开发场景。 接口基础信息汇总：
| 接口正式地址 | https://api.17zhiling.com/api/video/parse-video-url |
| 请求方式 | HTTP GET |
| 数据返回格式 | application/json |
| 文档编号 | doc/107 |
| 服务状态 | 正常在线 |
请求头规范
接口统一请求头配置，所有请求必须遵循该格式，否则会出现解析异常：
| Content-Type | application/x-www-form-urlencoded; charset=utf-8 |
请求参数详解
本接口为 GET 请求，参数直接拼接在 URL 后方，包含2 个必填参数，无选填参数，参数说明如下：
| 参数名 | 必填 | 数据类型 | 参数说明 | 示例值 | | —- | —- | —- | —- | | key | 是 | string | 接口密钥，开发者登录平台控制台，在密钥管理模块获取 | 35kj5jnlj53453kl5j43nj5 | | url | 是 | string | 待解析的短视频 / 图集分享链接
补充注意点：
3.1 请求示例
标准 GET 请求完整 URL 格式：
https://api.17zhiling.com/api/video/parse-video-url?key=你的接口密钥&url=短视频链接
返回数据结构与字段说明
接口调用成功或异常均返回标准JSON数据，分为外层通用字段和业务数据字段（data），同时区分普通视频、多视频合集、图集三种返回形态。
| code | int | 业务状态码，核心判断标识 |
| msg | string | 状态描述信息，异常时定位问题 |
| data | object | 解析后的业务核心数据 |
| exec_time | float | 接口执行耗时（单位：秒） |
| user_ip | string | 客户端请求 IP |
成功返回示例
{
"code": 200,
"msg": "获取成功",
"data": {
"title": "北京一名大学生在学校晕倒 抽搐 无意识…",
"desc": "北京一名大学生在学校晕倒 抽搐 无意识…",
"url": "https://wxapp.tc.qq.com/xxx",
"authorName": "法治进行时",
"authorAvatar": "https://wx.qlogo.cn/xxx",
"photo": "https://wxapp.tc.qq.com/xxx",
"picsList": []
},
"exec_time": 1.999323,
"ip": "111.194.4.79"
}
状态码与异常排查
接口定义三套核心业务状态码，覆盖正常、服务器异常、业务异常三大场景，开发过程中可根据状态码快速定位问题：
| 200 | 请求 & 解析全部成功 | 正常解析，直接读取 data 字段数据即可 |
| 500 | 服务器异常 | 接口服务临时故障，稍后重试；多次失败可联系平台客服 |
| -1 | 业务异常 | 1. 密钥 key 错误 / 过期；2. url 链接无效、格式错误；3. 免费额度耗尽；4. 请求频率超限 |
主流编程语言调用代码示例
以下提供 PHP、Java、Python、C# 四种后端主流语言完整可运行代码，代码基于官方 Demo 优化，适配当前接口规则，替换key和url即可直接使用。
6.1 PHP 调用示例（cURL 实现 GET 请求）
<?php
// 配置信息：替换为自己的密钥和视频链接
$apiKey = "你的接口密钥";
$videoUrl = urlencode("待解析的短视频链接"); // 对链接进行URL编码
// 接口地址
$apiUrl = "https://api.17zhiling.com/api/video/parse-video-url?key={$apiKey}&url={$videoUrl}";
// 初始化cURL
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
// 执行请求
$response = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);
if ($error) {
echo "请求失败：" . $error;
} else {
// 解析JSON结果
$result = json_decode($response, true);
print_r($result);
}
?>
