影视资源采集接口

本站提供标准 maccms 兼容采集接口，支持 XML 与 JSON 两种返回格式，可直接用于苹果 CMS、海洋 CMS、以及其他支持标准采集协议的建站程序。当前资源总数：24 部。

接口地址

类型	地址
XML 列表	`https://yingshiziyuan.30589.org/api.php/provide/vod/at/xml/` 复制
JSON 列表	`https://yingshiziyuan.30589.org/api.php/provide/vod/at/json/` 复制
XML 详情	`https://yingshiziyuan.30589.org/api.php/provide/vod/at/xml/?ac=detail` 复制
JSON 详情	`https://yingshiziyuan.30589.org/api.php/provide/vod/at/json/?ac=detail` 复制
分类列表	`https://yingshiziyuan.30589.org/api.php/provide/vod/at/json/?ac=class` 复制
按 ID 采集	`https://yingshiziyuan.30589.org/api.php/provide/vod/at/json/?ac=detail&ids=1,2,3` 复制
按分类采集	`https://yingshiziyuan.30589.org/api.php/provide/vod/at/json/?ac=detail&t=6&pg=1` 复制
按更新时间	`https://yingshiziyuan.30589.org/api.php/provide/vod/at/json/?ac=detail&h=24` 复制

请求参数

参数	取值	说明
`ac`	list / detail / class	list 输出简要列表，detail 输出完整详情（含 vod_play_url），class 输出分类
`at`	xml / json	返回格式，也可直接使用 `/at/xml/`、`/at/json/` 路径
`pg`	数字	页码，从 1 开始
`t`	分类 ID	按分类筛选，会自动包含子分类
`ids`	1,2,3	按影片 ID 精确采集，多个用英文逗号分隔
`wd`	关键字	按片名 / 主演 / 导演搜索
`h`	小时数	只采集最近 N 小时内更新的资源，如 `h=24`
`limit`	数字	每页条数，默认 20，最大 2000
`pass`	密钥	当后台开启了采集密钥时必填

返回字段说明

字段	说明
`vod_id`	影片唯一 ID
`type_id / type_name`	分类 ID 与分类名称
`vod_name`	影片名称
`vod_pic`	封面图地址
`vod_remarks`	更新备注，如“更新至第 10 集”
`vod_play_from`	播放源标识，如 ffm3u8
`vod_play_url`	播放地址，格式 `剧集名$地址#剧集名$地址`，多个播放源用 `$$$` 分隔
`vod_down_url`	下载地址，格式同播放地址
`vod_time`	更新时间

XML 返回示例

<?xml version="1.0" encoding="utf-8"?>
<rss version="5.1">
  <list page="1" pagecount="10" pagesize="20" recordcount="200">
    <video>
      <last>2026-09-18 12:00:00</last>
      <id>1</id>
      <tid>6</tid>
      <name><![CDATA[影片名称]]></name>
      <type><![CDATA[动作片]]></type>
      <dl><dd flag="ffm3u8"><![CDATA[第01集$http://xxx.m3u8#第02集$http://xxx.m3u8]]></dd></dl>
    </video>
  </list>
</rss>

JSON 返回示例

{
  "code": 1,
  "msg": "数据列表",
  "page": 1,
  "pagecount": 10,
  "limit": "20",
  "total": 200,
  "class": [{"type_id": 1, "type_name": "电影片"}],
  "list": [
    {
      "vod_id": 1,
      "type_id": 6,
      "type_name": "动作片",
      "vod_name": "影片名称",
      "vod_play_from": "ffm3u8",
      "vod_play_url": "第01集$http://xxx.m3u8#第02集$http://xxx.m3u8",
      "vod_time": "2026-09-18 12:00:00"
    }
  ]
}

使用提示

1. 采集器一般只需填写“接口地址”，选择 JSON 或 XML 格式即可自动识别。
2. 全量采集建议使用 ac=detail 获取完整字段。
3. 定时增量采集建议配合 h=24 只拉取最近更新。
4. 如需开启访问密钥，可在后台“系统设置”中填写采集密钥，采集时通过 &pass=密钥 传入。