基础信息
接口补充说明
请求:POST /api/v1/endpoints/tiktok;Authorization: Bearer API Key;JSON请求参数 url(必填)、all_qualities(布尔,默认false,最多3档,true返回上游可用全部清晰度)。返回结构:code/msg/platform/data,data 包含 type/title/cover/url/images/formats 等。仅解析用户传入的公开作品链接;供应商点数不足或失败返回503。成功扣本站2点。
请求头
| 参数 | 内容 | 说明 |
|---|---|---|
| Authorization | Bearer dcy_... | 必填;从用户中心创建 API Key |
| Content-Type | application/json | 必填;JSON 请求体 |
JSON 请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| url | 字符串 | 是 | 作品或平台分享链接(HTTP / HTTPS) |
| all_qualities | 布尔值 | 否 | 默认 false,返回最多3档供应商实际提供的不同画质;true 返回全部有据可查的清晰度。自有YouTube高清可能需要单独下载 audio_url 合并音轨 |
调用示例
请把示例中的密钥替换为自己的完整 API Key。
cURL
curl -X POST "https://api.dcykjgw.com/api/v1/endpoints/tiktok" \
-H "Authorization: Bearer dcy_你的完整密钥" \
-H "Content-Type: application/json" \
-d '{"url":"https://平台分享作品链接","all_qualities":false}'JavaScript
fetch('https://api.dcykjgw.com/api/v1/endpoints/tiktok', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer dcy_你的完整密钥'
},
body: JSON.stringify({"url":"https://平台分享作品链接","all_qualities":false})
}).then(res => res.json()).then(console.log);返回格式示例
以下展示通用失败响应;成功响应的媒体字段由对应平台解析器决定,以实际调用结果为准。
成功响应结构(字段随平台变化)
{
"code": 0,
"msg": "解析成功",
"platform": "平台名称",
"data": {}
}返回参数说明
| 字段 | 格式 | 说明 |
|---|---|---|
code | 数字 | 业务状态码,0 表示本次接口调用成功;非 0 时结合 msg 和 HTTP 状态码排查。 |
msg | 字符串 | 本次请求结果说明,成功时描述处理结果,失败时给出可读错误原因。 |
platform | 字符串 | 当前接口/平台标识,成功响应中用于区分具体接口来源。 |
data | 对象 | 接口业务数据;具体字段含义见下方本接口字段说明。 |
data.type | 字符串 | 解析内容类型,例如 video、image 等;不同平台可能略有差异。 |
data.title | 字符串 | 作品标题或正文摘要;平台未提供时可能为空。 |
data.author | 字符串/对象 | 作品作者信息;具体结构取决于对应平台公开数据。 |
data.cover | 字符串 | 封面图片 URL;平台未提供封面时可能为空。 |
data.url | 字符串/null | 主要视频或媒体地址;图文作品可能为空。 |
data.images | 字符串数组 | 图文作品图片地址列表;非图文内容通常不存在或为空。 |
data.music | 对象 | 背景音乐信息,只有对应平台和作品提供时才返回。 |
data.list / data.items | 数组 | 主页/列表类解析的作品列表;单作品解析通常不返回。 |
请求参数错误示例
{
"code": 422,
"msg": "请提供有效的 HTTP 或 HTTPS 平台链接"
}HTTP 401:API Key 无效;402:余额不足;403:禁止调用、包月到期或需要用户授权;429:频率、配额或并发上限;503:服务不可用。
在线测试
仅在当前页面内提交请求,API Key 不写入浏览器本地存储。
响应结果
填写参数后点击“发送测试请求”。