随机快手美女视频V1

# 随机美女短视频 API 文档 ## API描述 基于第三方视频源封装的随机美女短视频接口，支持**完全随机**（无参数）或**指定分类**返回短视频内容。支持MP4直链跳转和JSON数据返回两种模式，所有JSON响应均经过美化格式化，便于阅读。 **特点：** - 🎲 **零参数随机**：不传递任何参数时自动随机选择分类并返回视频 - 🏷️ **分类丰富**：16种视频分类可选 - 📱 **双模式输出**：支持直接播放(MP4)或JSON数据返回 - ✨ **响应美化**：JSON格式自动美化，带中文分类名称 --- ## 请求地址 ``` GET https://站点域名/api/sjspks/ksvideo.php ``` --- ## 请求参数 (JSON格式) ```json [ { "name": "id", "type": "string", "required": false, "description": "视频分类ID，不传则随机。可选值：jk(JK制服)、YuMeng(欲梦)、NvDa(女大学生)、NvGao(女高中生)、ReWu(热舞)、QingCun(清纯)、YuZu(玉足)、SheJie(蛇姐)、ChuanDa(穿搭)、GaoZhiLiangXiaoJieJie(高质量小姐姐)、HanFu(汉服)、HeiSi(黑丝)、BianZhuang(变装)、LuoLi(萝莉)、TianMei(甜妹)、BaiSi(白丝)" }, { "name": "type", "type": "string", "required": false, "description": "返回格式，不传默认mp4。可选值：mp4(直接跳转视频)、json(返回JSON数据)" } ] ``` --- 响应示例 (JSON格式) 1. 默认无参数请求（直接跳转视频） 请求： `GET /api/sjspks/ksvideo.php` 行为： 自动随机选择分类，HTTP 302跳转到视频直链 --- 2. 指定分类+MP4格式（直接跳转） 请求： `GET /api/sjspks/ksvideo.php?id=jk&type=mp4` 行为： 直接302跳转到对应分类视频 --- 3. JSON格式响应（美化后） 请求： `GET /api/sjspks/ksvideo.php?id=jk&type=json` 响应： ```json { "code": 200, "message": "success", "data": { "video_info": { "url": "https://txmov2.a.kwimgs.com/upic/2023/12/17/17/xxxxx.mp4", "direct_play": "https://txmov2.a.kwimgs.com/upic/2023/12/17/17/xxxxx.mp4" }, "category": { "id": "jk", "name": "JK制服" }, "request_params": { "id": "jk", "type": "json" }, "raw_response": { "status": "success", "link": "https://txmov2.a.kwimgs.com/..." } } } ``` --- 4. 错误响应示例 ```json { "code": 400, "message": "无效的分类ID", "data": { "available_categories": [ "jk", "YuMeng", "NvDa", "NvGao", "ReWu", "QingCun", "YuZu", "SheJie", "ChuanDa", "GaoZhiLiangXiaoJieJie", "HanFu", "HeiSi", "BianZhuang", "LuoLi", "TianMei", "BaiSi" ], "tip": "不传id参数将随机返回所有分类" } } ``` --- 使用场景 | 场景 | 请求示例 | 说明 | | :--- | :--- | :--- | | 完全随机视频 | `/api/sjspks/ksvideo.php` | 每次刷新随机分类 | | 指定JK视频 | `/api/sjspks/ksvideo.php?id=jk` | 直接播放JK分类 | | 获取JSON数据 | `/api/sjspks/ksvideo.php?id=jk&type=json` | 获取视频链接信息 | | 热舞分类 | `/api/sjspks/ksvideo.php?id=ReWu` | 直接播放热舞视频 | --- 注意事项 1. 默认行为：无任何参数时随机返回视频，适合作为"试试手气"功能 2. 视频来源：上游接口来自 `api.mmp.cc`，如上游失效本接口也会受影响 3. 缓存建议：视频URL具有时效性，建议前端不要长期缓存返回的链接 4. 合规使用：请确保使用场景符合当地法律法规

> **由 AI 生成**：本接口文档由 AI 根据配置信息自动生成，仅供参考，实际接口行为以服务端为准。 # 随机快手美女视频V1 接口文档 ## 接口简介 本接口基于第三方视频源封装，可随机返回快手平台的美女短视频内容。支持按分类筛选或完全随机获取，适用于内容聚合、素材下载等场景。接口无需鉴权，直接调用即可。 ## 请求说明 - **URL**：`https://api.xunjinlu.fun/api/sjspks/ksvideo.php` - **方法**：`GET` - **请求头**：`Accept: */*`（默认可省略） ## 请求参数 | 名称 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | string | 否 | 视频分类ID，不传则随机。可选值：`jk`、`YuMeng`、`NvDa`、`NvGao`、`ReWu`、`QingCun`、`YuZu`、`SheJie`、`ChuanDa`、`GaoZhiLiangXiaoJieJie`、`HanFu`、`HeiSi`、`BianZhuang`、`LuoLi`、`TianMei`、`BaiSi` | | `type` | string | 否 | 返回格式，默认`mp4`。可选值：`mp4`（直接跳转视频）、`json`（返回JSON数据） | ## 返回字段表（JSON模式） | 字段 | 类型 | 说明 | |------|------|------| | `code` | int | 状态码，200表示成功 | | `msg` | string | 状态描述 | | `data` | object | 视频数据对象 | | `data.url` | string | 视频直链（MP4格式） | | `data.title` | string | 视频标题 | | `data.category` | string | 视频分类名称 | | `data.cover` | string | 视频封面图链接（若有） | ## 返回 JSON 示例 ### 成功 ```json { "code": 200, "msg": "success", "data": { "url": "https://example.com/video.mp4", "title": "快手美女热舞", "category": "ReWu", "cover": "https://example.com/cover.jpg" } } ``` ### 失败 ```json { "code": 404, "msg": "分类不存在或无数据" } ``` ## 错误与状态 - `200`：成功 - `404`：分类不存在或无数据 - `500`：服务器内部错误 （以实际返回 `message` 为准） ## 调用示例 ### 直接访问 ```bash https://api.xunjinlu.fun/api/sjspks/ksvideo.php?id=ReWu&type=json ``` ### cURL ```bash curl "https://api.xunjinlu.fun/api/sjspks/ksvideo.php?id=QingCun" ``` ### Python requests ```python import requests url = "https://api.xunjinlu.fun/api/sjspks/ksvideo.php" params = {"id": "YuMeng", "type": "json"} response = requests.get(url, params=params) print(response.json()) ``` ### PHP ```php "NvGao", "type" => "json"]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url . "?" . http_build_query($params)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $response = curl_exec($ch); curl_close($ch); echo $response; ?> ``` ### HTML ```html ```