随机视频API文档

API简介

随机视频API提供多种分类的视频资源，支持JSON、URL和MP4三种返回格式，适用于各种开发场景。

API地址：https://acosr.cn/api/videoapi.php

HTTP请求

方法	描述	示例
GET	获取视频资源	`GET /api/videoapi.php?data=json&type=tuijian`
POST	获取视频资源（参数可通过请求体传递）	`POST /api/videoapi.php` (Body: data=json&type=tuijian)

参数说明

参数名	必填	类型	说明	可选值
`data`	是	string	指定返回格式	`json`, `url`, `mp4`
`type`	是	string	视频分类类型	`tuijian`, `bianzhuang`, `jklolita`, `luoli`, `shwd`, `tianmei`, `wmsc`, `xjj`, `xjj2`, `chuanda`, `cos`, `manyao`, `nvgao`, `qingchun`, `rewu`, `sbkl`, `shejie`, `yuzu`
`id`	否	integer	指定视频ID（不传则随机返回）	1 ~ 该分类视频总数

请求示例

GET https://acosr.cn/api/videoapi.php?data=json&type=tuijian

响应数据

JSON格式返回

字段	类型	说明
`code`	integer	状态码（200表示成功）
`msg`	string	状态信息
`data.id`	integer	视频ID
`data.video_url`	string	视频URL地址
`data.total_videos`	integer	该分类视频总数
`data.total_play_count`	integer	总播放量
`data.type_name`	string	分类名称

JSON响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "id": 1,
        "video_url": "/video/tuijian/video_1.mp4",
        "total_videos": 10,
        "total_play_count": 100,
        "type_name": "推荐系列"
    }
}

URL格式返回

直接返回视频URL字符串：

/video/tuijian/video_1.mp4

MP4格式返回

直接返回视频二进制流（Content-Type: video/mp4）

错误处理

错误码	说明	解决方案
400	参数错误	检查请求参数是否正确
404	视频/分类不存在	检查分类名称或视频ID
500	服务器内部错误	稍后再试或联系管理员

错误响应示例

{
    "code": 400,
    "msg": "无效的视频类型"
}