解析视频链接
允许已授权的用户通过此接口更新自己的信息。
-
URL:https://www.xiazaitool.com/api/parseVideoUrl
-
Method:
Post
-
需要登录:否
-
需要鉴权:是
请求参数
参数
|
类型
|
说明
|
约束
|
url
|
String
|
解析链接
|
需要符合解析平台链接要求,例如抖音中要包含 douyin.com
|
token
|
String
|
token
|
请联系我们获取
|
请求示例
可以仅传递部分请求参数。
{ "url":"https://v.douyin.com/iLxWK7jr/", "token":"test" }
响应参数
参数
|
参数
|
类型
|
是否必填
|
说明
|
status
|
int
|
是
|
状态码,200成功,500失败,429剩余额度不足
|
|
success
|
Boolean
|
是
|
是否成功
|
|
message
|
string
|
否
|
提示信息
|
|
data
|
object
|
是
|
响应数据
|
|
title
|
string
|
是
|
视频标题
|
|
coverUrls
|
string
|
是
|
封面图片链接
|
|
videoUrls
|
string
|
是
|
视频链接
|
|
leftTimes
|
string
|
是
|
剩余解析次数
|
|
isVideo
|
bool
|
是
|
是否为图片
|
|
like
|
int
|
否
|
点赞数
|
|
comment
|
int
|
否
|
评论数
|
|
collect
|
int
|
否
|
收藏数
|
|
createTime
|
string
|
否
|
作品发布时间
|
|
pics
|
array
|
否
|
图片链接解析的图片组,字符串集合
|
|
time
|
string
|
是
|
响应时间
|
成功响应
条件:请求参数合法,并且用户身份校验通过。
状态码:
200 OK
响应示例:响应会将修改后的用户信息数据返回,一个
id
为 1234 的用户设置他们的姓名后将会返回:{ "status": 200, "success": true, "message": "操作成功", "data": { "pics": null, "title": "一口气看完《苏里南》,全长38分钟#一剪到底 #韩剧 #苏里南 #唐人街 #我的观影报告", "coverUrls": "https://p3-sign.douyinpic.com/tos-cn-i-dy/aea49e53a154415d8da3675bafb0c4da~c5_300x400.webp?x-expires=1714176000&x-signature=3X2N9VdO%2BuNJlF3JYO%2Bqtsqd21c%3D&from=3213915784_large&s=PackSourceEnum_DOUYIN_REFLOW&se=false&sc=cover&biz_tag=aweme_video&l=20240413083200BFBCD80D76957F5287AA", "videoUrls": "https://v83-017.douyinvod.com/ddc2970e3ee1b33810f2bb6d778952ac/6619e99b/video/tos/cn/tos-cn-ve-15c001-alinc2/osGeBphZsZDStNDTAhucpigIzNAWfAUNNBmysE/?a=1128&ch=0&cr=0&dr=0&cd=0%7C0%7C0%7C0&cv=1&br=996&bt=996&cs=0&ds=3&ft=7EYOIDDhNdIVwMyJBMfusYLsGoySYsvJHqCThbLfK&mime_type=video_mp4&qs=0&rc=ZGc1NGYzN2k4ZDw0ZTs5OEBpM2dqcjQ6ZmhzbzMzNGkzM0BhMl5gNDAyNl8xLjAvNi5iYSMwbmEucjQwYjNgLS1kLTBzcw%3D%3D&btag=10e000b8001&cquery=100y&dy_q=1712968320&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20240413083200ED14CBB5F8F9AA4347D7", "leftTimes": 11980, "isVideo": true, "like": 140867, "comment": 2459, "collect": 29662, "createTime": "2023-11-10 11:02:24" }, "time": "2024-04-13 08:32:01" }
错误响应
条件:请求数据非法,例如 url不符合规则。
状态码:
500 BAD REQUEST
响应示例:
{
"status": 500,
"success": false,
"message": "链接不符合要求!",
"data": null,
"time": "2024-04-13 08:35:54"
}
注意事项
💡 以上出入参全部采用json格式字符串传输
调用示例
Python
import requests
# 定义请求的URL
url = "https://www.xiazaitool.com/api/parseVideoUrl"
# 定义请求参数
payload = {
"url": "https://v.douyin.com/iLxWK7jr/",
"token": "test"
}
# 定义请求头(可选)
headers = {
"Content-Type": "application/json"
}
# 发送 POST 请求
response = requests.post(url, json=payload, headers=headers)
# 输出响应状态码和内容
print("Status Code:", response.status_code)
print("Response Body:", response.json())
Java
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
public class PostRequestExample {
public static void main(String[] args) {
try {
// 1. 定义请求的 URL
URL url = new URL("https://www.xiazaitool.com/api/parseVideoUrl");
// 2. 打开连接
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Content-Type", "application/json"); // 设置请求头
conn.setDoOutput(true);
// 3. 定义请求参数(JSON 格式)
String jsonInputString = "{\"url\": \"https://v.douyin.com/iLxWK7jr/\", \"token\": \"test\"}";
// 4. 发送请求
try (OutputStream os = conn.getOutputStream()) {
byte[] input = jsonInputString.getBytes("utf-8");
os.write(input, 0, input.length);
}
// 5. 获取响应
int responseCode = conn.getResponseCode();
System.out.println("Response Code: " + responseCode);
conn.disconnect();
} catch (Exception e) {
e.printStackTrace();
}
}
}
PHP
<?php
// 请求的 URL
$url = "https://www.xiazaitool.com/api/parseVideoUrl";
// 参数数据
$data = [
"url" => "https://v.douyin.com/iLxWK7jr/",
"token" => "test"
];
// 使用 curl 发起请求
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); // 转换为 JSON 格式
// 执行请求并获取响应
$response = curl_exec($ch);
// 检查是否有错误
if (curl_errno($ch)) {
echo 'Curl error: ' . curl_error($ch);
} else {
echo "Response: " . $response;
}
// 关闭curl会话
curl_close($ch);
?>