用脚本或第三方工具对接采集接口时，真正影响开发效率的不是资源数量，而是参数响应是否规范、返回结构是否稳定。辣椒资源（别名：辣椒资源站、辣椒采集接口）的接口参数行为比较规范，返回结构整齐，适合需要自动化采集流程的站点接入。本词条从接口地址格式、参数释义、配置要点与异常排查等维度做档案式整理，并记录别名变体与适用程序，供建站者比对选型。
基本信息
| 词条名 | 辣椒资源 |
|---|---|
| 别名变体 | 辣椒资源站、辣椒采集接口 |
| 接口类型 | 苹果CMS V10标准采集接口 |
| 数据格式 | JSON与XML双格式输出 |
| 常见资源形态 | m3u8切片直链为主 |
| 适用CMS | 苹果CMS V10（maccms10）及兼容V10接口规范的程序 |
| 更新频率评价 | 更新连续性好，适合脚本按固定周期轮询 |
| 资源清晰度评价 | 整体以常规画质为主，标注信息相对可信，仍建议抽检 |
接口地址格式
辣椒资源的接口符合V10规范，基础路径为 api.php/provide/vod/，参数以查询串形式附加。对脚本采集来说，地址的价值在于"可组合"：列表与分页组合用于遍历，详情与编号组合用于抽验，时间参数与列表组合用于增量。以下为三类典型格式，域名部分替换为你自己的接入形态即可，正式地址以资源方公布为准。
http://你的域名/api.php/provide/vod/?ac=listhttp://你的域名/api.php/provide/vod/?ac=list&pg=2http://你的域名/api.php/provide/vod/?ac=detail&ids=1参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 请求动作，list与detail二选一 | ac=list |
| at | 输出格式，xml时返回XML文档，默认JSON | at=xml |
| pg | 页码参数，脚本遍历时递增此值 | pg=2 |
| ids | 编号列表，逗号分隔，detail动作的查询目标 | ids=2,6 |
| h | 时间窗口，单位小时，用于增量拉取 | h=24 |
| t | 分类编号，限定返回某一分类的数据 | t=6 |
| wd | 检索词，按片名匹配接口内条目 | wd=测试 |
配置要点
- 参数组合先在浏览器验通：脚本上线前，把要用的每种参数组合手工请求一遍，确认返回结构与字段名，再写进采集逻辑，能省掉大量联调时间。
- 详情抽验机制：每轮批量采集后随机抽取若干编号走detail请求，比对列表数据与详情数据的一致性，及时发现源端字段变动。
- 编码与转义处理：wd等中文参数务必做URL编码，XML分支下注意特殊字符转义，这两点是脚本采集中最常见的隐性故障源。
- 失败重试与日志：为每次请求设置超时与有限次重试，日志记录请求地址、返回码与入库条数，出问题时能按时间轴回放定位。
- 入库字段校验：脚本入库前校验标题、编号、播放地址三个必备字段，空值条目单独落盘待查，避免脏数据混进正库。
常见问题
用脚本对接时，参数应该按什么顺序组合？
先定动作再叠过滤：基础串固定为动作参数，其后依次叠加页码、分类、时间窗，搜索词单独用于定位场景。顺序本身不影响多数服务端的解析，但固定一套书写顺序有利于日志比对与缓存命中，也便于团队协作时保持脚本可读。
返回的中文变成乱码，问题出在哪？
先确认请求与解析两端都按接口声明的编码处理，XML分支还要核对文档头声明；若浏览器打开正常而脚本解析乱码，问题多在本方解码环节而非接口本身。最后检查入库环节的数据库字符集设置，三处编码一致才能全程无损。
白天采集正常，换到晚上量就骤减，是什么原因？
晚间是全网的访问高峰，接口响应变慢会触发脚本的超时跳过逻辑，表现为入库量骤减。把超时阈值适度放宽、重试次数增加一到两次，并将大批量任务挪到凌晨执行；如果调整后仍异常，再怀疑源端限流或自身网络问题。