第一次配采集接口的人，多半被看不懂的报错劝退过。红袖资源（别名：红袖资源网、红袖采集接口）在这方面对新手比较友好，出错时返回的提示相对直白，顺着提示大多能定位到问题环节。本词条以档案方式记录其接口地址格式、参数含义、接入步骤与常见疑问，供刚上手的建站者对照使用。
基本信息
| 词条名 | 红袖资源 |
|---|---|
| 别名变体 | 红袖资源网、红袖采集接口 |
| 接口类型 | 苹果CMS V10标准采集接口 |
| 数据格式 | JSON为主，同时支持XML输出 |
| 常见资源形态 | m3u8切片直链为主 |
| 适用CMS | 苹果CMS V10（maccms10）及兼容V10接口规范的程序 |
| 更新频率评价 | 更新平稳，长时间观察未见明显断档 |
| 资源清晰度评价 | 常规画质为主，热门条目可见高清版本 |
接口地址格式
接入这类接口时，建议把请求拆成最小单位逐个验证：先拉列表看整体结构，再取单条详情看字段完整性，最后试一次格式切换。基础路径仍是 http://你的域名/api.php/provide/vod/ 的通用形态，三个阶段的格式示例如下，正式接入时以资源方提供的地址替换"你的域名"部分。
http://你的域名/api.php/provide/vod/?ac=listhttp://你的域名/api.php/provide/vod/?ac=detail&ids=1http://你的域名/api.php/provide/vod/?at=xml参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 动作指令，list输出列表集合，detail输出单条完整字段 | ac=list |
| at | 输出格式控制，xml切换为XML，缺省即JSON | at=xml |
| ids | 条目编号，detail模式必填，逗号分隔可一次多取 | ids=1,2 |
| pg | 列表页码，从第一页起逐页向后翻 | pg=1 |
| h | 小时窗口，圈定最近一段时间内的新增数据 | h=24 |
| t | 栏目编号过滤，缩小列表的返回范围 | t=6 |
| wd | 片名检索，按关键词查询接口库存 | wd=示例 |
配置要点
- 从手动单次采集起步：不要一上来就开定时任务，先在采集界面手动执行一次，把整条流程走通；采集链路的整体逻辑可参考资源采集原理科普：从接口到入库再到播放的完整链路。
- 先读报错再动手：接口返回的提示通常直接写明失败原因，按提示逐项修正，比盲目重试省时间。
- 用详情接口验证字段：以ids指定一部影片单独请求，确认标题、分类、播放地址三类字段完整后再扩大范围。
- 稳定后再上定时：手动轮次跑顺后设定时任务，间隔先放宽，观察几轮日志没有异常再收紧。
- 播放器一次配对：m3u8播放器绑定到采集来源后不必频繁改动，前台点播异常时优先检查绑定关系。
常见问题
后台提示采集失败，第一步检查什么？
第一步看返回的提示文本，确认是地址写错、网络不通还是参数问题。把接口地址原样粘到浏览器里请求一次，能返回数据就说明接口本身正常，问题多半出在程序配置或服务器出网环境上。
参数随手乱填会怎么样？
取值超出接口约定范围时，通常返回空列表或原样忽略该参数，不会损坏已有数据；但格式参数与动作参数组合错误时，可能拿到解析不了的返回体。不确定时先单独试一个参数，逐步叠加。
采集成功的条目前台点不开，问题出在哪？
数据入库只说明采集环节通了，播放异常多与播放器绑定有关：确认m3u8播放器已启用并关联到该采集来源，再检查条目的播放地址字段是否为空。播放环节的更多故障现象可查阅苹果CMS播放器问题排查手册：黑屏、卡顿、不自动连播。