短视频解析接口使用指南（适配阿里云发布）

本文将详细介绍一款实用的短视频解析接口，该接口可快速解析短视频相关信息，包括视频标题、视频链接、封面链接及图集信息，适用于各类需要获取短视频基础数据的场景，以下是完整的接口使用说明及常见问题解答。

一、接口功能概述

本接口核心功能为短视频解析，支持通过输入目标短视频链接，快速获取以下关键信息，满足多场景数据调用需求：

• 视频标题：短视频的官方标题内容

• 短视频链接：可直接访问或下载的视频源链接

• 短视频封面：短视频的封面图片链接

• 图集信息：若短视频包含图集内容，将返回图集相关数据（无图集时返回空数组）

二、接口调用方式

2.1 基础调用信息

• 域名前缀：请前往后台首页接口示例查看具体域名

• 请求方式：支持 GET 与 POST 两种请求方式，可根据实际开发需求选择

• 请求链接：https://watermark-api.hlyphp.top/Watermark/Index

2.2 请求参数说明

接口请求需传入两个必填参数，参数规范如下表所示，缺失任一参数将导致请求失败：

属性	类型	是否必填	说明
appid	string	是	需前往后台个人主页获取，用于接口身份验证
link	string	是	需要解析的短视频链接（如抖音、快手等平台短视频链接）

三、返回参数说明

3.1 基础返回参数

接口返回数据为 JSON 格式，核心基础参数说明如下：

• code：状态码，1 表示解析成功，其他数值均表示解析失败（具体失败原因可参考下方错误说明）

• msg：提示信息，解析成功时返回“解析成功”，失败时返回具体失败原因

• data：解析结果主体，包含短视频核心信息（解析失败时为空数组）

3.2 data 内容详情

当解析成功（code=1）时，data 字段将返回以下具体信息，字段规范如下：

属性	类型	说明
title	string	短视频的官方标题
videoSrc	string	短视频的源链接，可用于直接访问或下载视频
imageAtlas	array	短视频关联的图集信息，无图集时返回空数组
imageSrc	string	短视频的封面图片链接
link	string	本次解析的原始短视频链接（与请求参数中的 link 一致）

四、解析成功示例

以下为接口解析成功时的完整返回示例，可参考该格式进行数据解析与调用：

{ "code": 1,"msg": "解析成功","data": {   "title": "“有些人，有些事，光是遇见就已经很幸运了。”",  "videoSrc": "https://v26-default.365yg.com/ed0fa7cdc9ef327bffb9ab3ec9d270af/66f260fc/video/tos/cn/tos-cn-ve-15/osEM4ReeQX6ARSWANAfAw1r8YwF7CPB4igBH5k/?a=2011&ch=0&cr=0&dr=0&net=5&cd=0%7C0%7C0%7C0&cv=1&br=4098&bt=4098&cs=0&ds=4&ft=k7Fz7VVywIiRZm8Zmo~6RXMkWApTaKVwvrK78cBkto0g3cI&mime_type=video_mp4&qs=0&rc=aTM3OjU7OWc5O2U6MzZkZUBpMzpya2o5cjRvdTMzNGkzM0A0MGE1YzUzNWAxNV8tMl8yYSNzNm1pMmRzcGxgLS1kLS9zcw%3D%3D&btag=c0000e00008000&dy_q=1727156964&feature_id=46a7bb47b4fd1280f3d3825bf2b29388&l=202409241349246C8411D6F350709322AE",  "imageAtlas": [],  "imageSrc": "https://p3-sign.douyinpic.com/tos-cn-i-0813/oYAQXKnCBIDnRx88AKiAC298RCfOmAAEiJgTAe~c5_300x400.jpeg?x-expires=1728363600&x-signature=nfg2989RX6C9NhwsxiiA2sMCDv8%3D&from=327834062_large&s=PackSourceEnum_AWEME_DETAIL&se=false&sc=cover&biz_tag=aweme_video&l=202409241349236A0F2612AA2D3E605ED4",  "link": "https://www.douyin.com/video/7411428849830923555"},"count": 0
}

五、常见错误及解决方案

结合实际调用测试，整理以下常见错误场景及对应解决方案，帮助快速排查问题：

• 错误场景1：返回 code=201，msg=“未检测到用户信息，如需解析更多链接，请前往 http://watermarkuser.hlytools.top 获取appid使用”解决方案：未传入有效 appid 或 appid 未完成验证，需前往指定地址获取并正确传入 appid。

• 错误场景2：提示“网页解析失败，可能是不支持的网页类型，请检查网页或稍后重试”解决方案：该错误多出现于解析非短视频链接（如图片链接、普通网页链接）或平台限制解析的链接，需确认传入的 link 为支持解析的短视频链接，或稍后重新尝试解析。

• 错误场景3：提示“该视频为非公开视频，无法访问”解决方案：目标短视频为私密视频、已删除视频或权限受限视频，无法通过接口解析，需更换公开可访问的短视频链接。

六、注意事项

• appid 为接口调用的核心凭证，请勿泄露给无关人员，避免接口被滥用。

• 请确保传入的 link 为有效、公开的短视频链接，非公开或无效链接将导致解析失败。

• 接口支持的短视频平台以后台说明为准，若解析特定平台链接失败，可检查是否为平台接口更新导致，建议稍后重试。

• 调用接口时请遵守相关平台的版权规定，不得用于爬取、滥用他人短视频内容，避免产生法律风险。

（注：文档部分内容可能由 AI 生成）