接口返回格式决定了苹果CMS怎么解析数据，选错格式是「采集返回空」的高频原因之一。判断方法其实很简单：浏览器打开接口看一眼返回内容的开头就能确定。
json 与 xml 的区别
xml 是老格式，标签成对、体积偏大、解析慢；json 是键值对结构、体积小、程序解析友好。对站长来说实际差别就两点：新资源站默认给 json；少数老源只有 xml。两者承载的数据内容本身没有优劣之分，区别只在解析方式。
判断时有一个高频误区：把接口地址里的 ac=detail 参数误当成格式标识，这个参数控制的是返回内容详略，与 json 还是 xml 无关。另外部分源站同时提供两个入口，路径里带 json 或 xml 字样的分支，按路径选即可，不必自己转格式。
苹果CMS对两种格式的支持
苹果CMS的自定义接口添加时可以直接选类型，json 与 xml 都在支持范围内。选型原则是：接口给什么就选什么，不要凭习惯全选 json。类型与实际返回不一致时，程序解析会直接失败，表现就是试采为空。
如何判断接口返回格式
把接口地址粘到浏览器打开：返回以 { 开头、内容是形如 code:1 的键值对，就是 json；返回以 <rss> 或 <list> 这类标签嵌套开头的，就是 xml。如果打开后看到的是一整个网页而不是数据文本，说明这个地址根本不是标准采集接口。
浏览器判断还有两个细节：json 返回在部分浏览器里会被折叠显示，要切换到原始文本视图再看开头字符；xml 返回则会渲染成可折叠的节点树。把两种表现记熟，现场判断不超过十秒。
实测的 json 结构长什么样
本站于 2026-10-07 在服务器侧实测电影天堂接口 caiji.dyttzyapi.com/api.php/provide/vod/，返回标准 json：外层是 code、page、pagecount 等分页字段，list 数组里每部影片是一个对象，包含 vod_id、vod_name、type_id、vod_time 与播放地址串等字段。看懂这一层结构，接口报错时就能快速定位是字段缺失还是格式问题，多源并行时的格式管理可参考多采集源轮询策略。
选格式的实用建议
新站直接用 json 源即可；接手老站遇到 xml 源也不必转格式，程序原生支持。真正要盯的是数据字段完整度，尤其是播放地址串的拼接格式，它比外层格式更容易出问题，相关排查可参考播放器问题排查手册。接口配置操作见苹果CMS采集接口怎么配置，数据来源背景见资源采集原理科普。