API接口

解析视频链接

允许已授权的用户通过此接口更新自己的信息。
  • URL:https://www.xiazaitool.com/api/parseVideoUrl
  • MethodPost
  • 需要登录:否
  • 需要鉴权:是

请求参数

参数
类型
说明
约束
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); ?>