📡 BDSM 采集接口具体参数说明

本接口将视频资源按苹果 CMS 标准格式输出，支持列表、详情、搜索、分类与时间筛选等功能。请按以下步骤在苹果 CMS 后台完成绑定并开始采集。

1. 接口地址与基础信息

接口基础 URL： https://bdsmbloc.com/api/maccms/api.php [请使用HTTPS]

项目	说明
接口类型	苹果 CMS 标准 JSON 采集接口
请求方式	GET
字符编码	UTF-8
默认每页条数	20 条
认证方式	无（接口内部连接 MongoDB 通过配置文件认证）

2. 苹果 CMS 后台绑定步骤

第 1 步： 登录苹果 CMS 后台，点击左侧菜单 “资源库” → “自定义资源库”（或“资源站管理”）。

第 2 步： 点击右上角 “添加” 按钮，填写资源站信息：

资源站名称： 例如 BDSM 视频库
接口地址： https://bdsmbloc.com/api/maccms/api.php （与上文一致）
接口类型： 选择 苹果CMS标准接口 或 JSON

第 3 步： 保存后，在资源库列表中找到刚添加的资源站，点击右侧 “采集” 或 “绑定” 按钮。

第 4 步： 系统会自动识别可用的分类参数。如需按分类绑定，可根据页面提示选择分类或直接输入参数（如 cate=动作）。完成绑定后即可开始一键采集。

3. 支持的功能与参数详解

所有参数通过 URL 查询字符串传递，苹果 CMS 会根据配置自动附加。

参数名	类型	作用	示例
`ac`	string	操作类型：`list`（列表）或 `detail`（详情）	`ac=list`
`pg`	int	页码，从 1 开始	`pg=2`
`cate`	string	按分类精确筛选（字段 `cate`）	`cate=悬疑`
`wd`	string	搜索关键词，仅匹配标题（`title` 字段）	`wd=未来`
`year`	int	按年份筛选，从 `intotime` 字段提取	`year=2025`
`h`	int	最近 N 小时内更新的资源（基于时间戳 `intotime_s`）	`h=24`
`ids`	string	仅用于 `ac=detail`，多个 ID 用英文逗号分隔	`ids=abc123,xyz789`

⚠️ 注意： 分类参数 cate 为文本字段，区分大小写，且每次只能传入一个分类（不支持多分类逗号分隔）。
小时筛选 h 仅对规范时间戳生效，不规则日期（如“1天前”）会被自动排除。

4. 接口返回字段说明（符合苹果 CMS 规范）

每次返回的 JSON 中，list 数组内包含视频对象，关键字段如下：

字段名	含义	数据来源 / 备注
`vod_id`	视频唯一编号	MongoDB 的 `id` 字段
`vod_name`	视频标题	`title`
`vod_en`	英文标题	`title_english`
`vod_time`	上映时间	由 `intotime` 格式化（不规则时间固定为 2026-05-10）
`vod_pic`	图片标识字符串	`id#tid#sd#ud` 拼接
`vod_play_url`	播放地址	`正片$id#tid#sd#ud`
`vod_director`	导演	`author`
`vod_actor`	主演	`author`（与导演相同）
`vod_blurb`	简介	`stext_1`
`vod_content`	详细内容（序列化）	文档中除 `hd`、`text` 字段外的 JSON 字符串
`vod_remarks`	备注	与 `vod_content` 相同
`vod_tag`	TAG 标签	`sword`
`vod_class`	分类	`cate`
`vod_area`	地区	固定为“全球”
`vod_lang`	语言	固定为“中文”
`vod_total`	总集数	固定为 1
`vod_series`	系列数	固定为 1
`vod_continu`	片长（秒）	`vlong_s`

💡 关于图片与播放地址的说明：
目前存储为 id#tid#sd#ud 格式的标识字符串，并非直链 URL。您需要在自己的播放器或模板中解析该字符串，再通过您的后端服务获取真实图片/视频地址。这种方式隐藏了源站信息，且便于灵活控制。

5. 常用采集操作示例

以下为直接访问接口的测试 URL，也可在 CMS 采集设置中对应使用。

5.1 采集最新资源（最近 24 小时）

https://bdsmbloc.com/api/maccms/api.php?ac=list&h=24&pg=1

5.2 按分类采集（例如“动作”）

https://bdsmbloc.com/api/maccms/api.php?ac=list&cate=动作

5.3 搜索标题包含“特工”的视频

https://bdsmbloc.com/api/maccms/api.php?ac=list&wd=特工

5.4 筛选 2024 年的资源

https://bdsmbloc.com/api/maccms/api.php?ac=list&year=2024

5.5 获取指定 ID 的详情

https://bdsmbloc.com/api/maccms/api.php?ac=detail&ids=tt001,tt002

5.6 翻页

https://bdsmbloc.com/api/maccms/api.php?ac=list&pg=3

6. 苹果 CMS 计划任务自动采集

如果希望每天定时自动更新最近资源，可在 CMS 后台的 “系统” → “计划任务” 中添加一条任务：

任务类型： 采集资源 - 自定义资源库
资源站： 选择已绑定的 BDSM 接口
执行周期： 建议每 30 分钟或每小时一次
附加参数： h=24 （可根据需要调整）

这样 CMS 会定期请求 cms.php?ac=list&h=24&pg=1 并自动翻页入库，实现无人值守更新。

7. 常见问题（FAQ）

Q: 为什么图片和播放地址不是以 http 开头的链接？

A: 接口设计为返回标识符字符串，您可以在播放器或模板中使用 explode('#', $vod_pic) 解析出各个字段，然后调用自己的后端接口获取真实 URL。这样做既安全又灵活。

Q: 分类筛选无效？

A: 请检查数据库中 cate 字段的值是否完全一致（区分大小写）。接口采用精确匹配，不支持模糊搜索分类。

Q: 时间显示为“2026-05-10”是为什么？

A: 当 MongoDB 中的 intotime 字段格式不是标准的 YYYY-MM-DD 时（例如“1天前”），接口会统一返回固定日期 2026-05-10。建议修正源数据以保证时间准确性。

Q: 接口返回的总数不准确？

A: 请确认 MongoDB 索引是否存在且正确。在筛选条件较多时，聚合计数可能受索引影响。如果数据量极大，建议为 cate、intotime_s 等字段建立索引。

📌 温馨提醒：
· 请确认您已经设置好了分类，再进行采集，初次采集请绑定分类，具体可看官网视频教程。

📡 BDSM 采集接口 具体参数说明