每接入一个新资源站，都要走一次自定义接口添加流程。操作本身两分钟，但地址、类型、分类三处任何一处填错，后续采集就会莫名失败，本文把步骤和错点一次性讲清。
添加前的准备
需要两样东西：一个确认可用的接口地址，怎么找、怎么验，见影视资源采集站大全与资源采集原理科普；另外是对本站分类体系的初步规划，分类没想清楚就添加接口，绑定时会来回返工。
添加步骤
第一步，登录后台进入「采集－自定义接口」；第二步，点添加，填写接口名称，建议用「源名+备注」格式；第三步，粘贴接口地址，确认以 http 或 https 开头且无多余空格；第四步，选择数据类型，主流源选 json；第五步，保存并回到列表确认状态正常。全流程的图文版可参考苹果CMS采集接口怎么配置教程。
几个字段的具体填法：接口名称只影响后台列表展示，写清楚源名即可，程序不校验；接口地址末尾的斜杠有无要照搬源站给的写法，不要自作主张增删；数据类型选错时不会有保存报错，只有试采为空这一个信号，所以保存后必须立即试采一次，而不是等定时任务来暴露问题。
三类高频填错点
地址类：复制时带上了空格或中文标点、漏了路径部分。类型类：接口实际返回 xml 却选了 json，试采必然为空。分类类：保存后跳过分类绑定直接全量采集，数据会堆积在错误分类或待审区。三处按顺序自查，绝大多数「添加成功但采不到」都出在这里。
排查顺序也有讲究：先核对地址，浏览器能打开且有数据再谈其他；再核对类型，对照浏览器里看到的返回开头字符；最后才查分类绑定。很多人一上来就重装程序，其实九成问题出在这三处，按顺序过一遍比任何大动作都快。
添加完成后的验证
验证动作有两步：先试采拉几条数据，核对标题、分类、播放地址；再检查接口的更新时间字段是否新鲜，判断源是否还在维护。验证通过后再接入定时任务，安排方式见苹果CMS定时采集教程。
安全提醒
来源不明的接口地址不要直接加进生产站，先在测试环境跑一遍，确认返回数据干净再上线，防护思路见采集接口安全防护。接口列表也要定期清理不再使用的条目，降低误采风险，各源的全景资料见2026影视采集接口全景图。