随机快手美女视频v2

接口说明

随机快手美女视频API是一个从本地数据源随机返回快手视频链接的接口（本地1.5w条视频数据）。支持按分类获取视频，也可随机返回。提供JSON格式返回和302跳转两种模式，适用于视频聚合、随机推荐等场景。

调用地址

https://openapi.xunjinlu.fun/api/sjspks/v2.php

请求方式

GET

密钥与鉴权

本接口为必须密钥接口，调用方需提供有效的接口访问密钥。本接口支持以下三种鉴权方式：

1. Query 参数：将密钥作为 key 参数附加在URL中。
2. Header：在请求头中设置 X-API-Key 字段。
3. Bearer Token：在请求头中设置 Authorization: Bearer。

请求参数

分类参数取值表

参数 c 支持以下分类编号及对应名称：

返回参数说明

成功响应示例

JSON 格式返回示例：

{
    "code": 200,
    "msg": "success",
    "data": {
        "url": "https://v.kuaishou.com/xxxxx",
        "category": {
            "id": 5,
            "name": "小仙"
        },
        "total_categories": 52
    },
    "api_info": {
        "developer": "尋鯨錄",
        "blog": "https://www.xunjinlu.fun",
        "api_platform": "https://api.xunjinlu.fun"
    }
}

MP3/MP4 跳转模式说明：

当参数 type 设为 mp4 时，接口将直接返回 302 状态码并重定向至视频文件地址，而非返回 JSON 数据。

错误响应示例

当请求发生错误时，接口将返回 JSON 格式的错误信息，code 为 0，并通过 errcode 字段标识具体的业务错误类型。

{
    "code": 0,
    "msg": "未提供调用密钥",
    "errcode": 11001
}

业务错误码说明

调用示例

PHP 示例

// PHP 调用示例
$key = 'your_api_key_here';
$category = 5; // 可选，不传或传0为随机

// 构造请求URL
$apiUrl = 'https://openapi.xunjinlu.fun/api/sjspks/v2.php?key=' . urlencode($key) . '&type=json&c=' . $category;

// 初始化 cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 执行请求
$response = curl_exec($ch);
curl_close($ch);

// 解析JSON
$result = json_decode($response, true);

if ($result && $result['code'] == 200) {
    echo "视频链接: " . $result['data']['url'];
} else {
    echo "请求失败: " . $result['msg'];
}

JavaScript (Fetch) 示例

// JavaScript Fetch 调用示例
const key = 'your_api_key_here';
const category = 5; // 可选

fetch(`https://openapi.xunjinlu.fun/api/sjspks/v2.php?key=${key}&type=json&c=${category}`)
    .then(response => response.json())
    .then(data => {
        if (data.code === 200) {
            console.log('视频链接:', data.data.url);
        } else {
            console.error('请求失败:', data.msg);
        }
    })
    .catch(error => console.error('网络错误:', error));

Python 示例

# Python 调用示例
import requests

key = 'your_api_key_here'
category = 5  # 可选

url = 'https://openapi.xunjinlu.fun/api/sjspks/v2.php'
params = {
    'key': key,
    'type': 'json',
    'c': category
}

response = requests.get(url, params=params)
result = response.json()

if result['code'] == 200:
    print('视频链接:', result['data']['url'])
else:
    print('请求失败:', result['msg'])