校园外卖市场还值得做吗?一文看懂校园外卖系统源码开发搭建
2026-05-19 3330247
2026-05-19 0
本文将详细介绍一款实用的短视频解析接口,该接口可快速解析短视频相关信息,包括视频标题、视频链接、封面链接及图集信息,适用于各类需要获取短视频基础数据的场景,以下是完整的接口使用说明及常见问题解答。

本接口核心功能为短视频解析,支持通过输入目标短视频链接,快速获取以下关键信息,满足多场景数据调用需求:
视频标题:短视频的官方标题内容
短视频链接:可直接访问或下载的视频源链接
短视频封面:短视频的封面图片链接
图集信息:若短视频包含图集内容,将返回图集相关数据(无图集时返回空数组)
域名前缀:请前往后台首页接口示例查看具体域名
请求方式:支持 GET 与 POST 两种请求方式,可根据实际开发需求选择
请求链接:https://watermark-api.hlyphp.top/Watermark/Index
接口请求需传入两个必填参数,参数规范如下表所示,缺失任一参数将导致请求失败:
| 属性 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| appid | string | 是 | 需前往后台个人主页获取,用于接口身份验证 |
| link | string | 是 | 需要解析的短视频链接(如抖音、快手等平台短视频链接) |
接口返回数据为 JSON 格式,核心基础参数说明如下:
code:状态码,1 表示解析成功,其他数值均表示解析失败(具体失败原因可参考下方错误说明)
msg:提示信息,解析成功时返回“解析成功”,失败时返回具体失败原因
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 生成)