采集与接口
Provide 数据 API
MacCMS provide 接口的列表、详情、分类、分页和 JSON／XML 格式，附请求示例及返回值检查。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
Provide 用来输出内容，不是写入接口。后台对应模型的数据 API 必须开启；新安装默认可能关闭。
请求一页视频
GET /api.php/provide/vod/?ac=list&pg=1| 参数 | 用途 | 示例 |
|---|---|---|
| ac | list 列表，detail 详情 | detail |
| t | 分类 ID | 1 |
| pg | 页码 | 2 |
| wd | 搜索词 | 测试 |
| h | 最近多少小时更新 | 24 |
| ids | 指定详情 ID，逗号分隔 | 1,2 |
| at | 输出格式 | xml；默认通常为 JSON |
获取指定内容
GET /api.php/provide/vod/?ac=detail&ids=1,2把 ID 换成本站存在的数据。文章用 provide/art，演员 actor，角色 role，网址 website，漫画 manga；不同模型字段不同。
返回值怎么读
成功结果通常包含 code、msg、page、pagecount、limit、total 和 list。先确认 code，再遍历 list；不要把 HTTP 200 直接当作接口成功。空 list 可以是没有匹配数据，也可能是分类／审核状态限制。
验收步骤
- 后台启用需要的模型 API，并记录权限设置。
- 请求一页列表，核对 ID 与后台数据。
- 请求这些 ID 的详情，确认名称、图片和来源地址。
- 测试不存在 ID 和下一页，确认客户端能处理空结果。
- 关闭接口后再次访问，确认访问策略生效。
XML 客户端还需解析 XML，不要按 JSON 读取。新式 offset／rows 接口见API V2。