短视频解析接口使用指南（适配阿里云发布）
本文将详细介绍一款实用的短视频解析接口，该接口可快速解析短视频相关信息，包括视频标题、视频链接、封面链接及图集信息，适用于各类需要获取短视频基础数据的场景，以下是完整的接口使用说明及常见问题解答。
一、接口功能概述
本接口核心功能为短视频解析，支持通过输入目标短视频链接，快速获取以下关键信息，满足多场景数据调用需求：
视频标题：短视频的官方标题内容
短视频链接：可直接访问或下载的视频源链接
短视频封面：短视频的封面图片链接
图集信息：若短视频包含图集内容，将返回图集相关数据（无图集时返回空数组）
二、接口调用方式
2.1 基础调用信息
域名前缀：请前往后台首页接口示例查看具体域名
请求方式：支持 GET 与 POST 两种请求方式，可根据实际开发需求选择
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 生成）
