接口文档写得齐全、参数说明与查询功能一目了然，是天空资源网（别名：天空资源、天空采集接口）区别于不少同类站的地方。对刚接触采集的新手而言，这种"照着文档就能发请求"的体验能省去大量试错时间。本词条以档案视角整理其地址格式、参数含义、配置要点与常见问题，并记录别名变体与适用程序，供查阅比对。
基本信息
| 词条名 | 天空资源网 |
|---|---|
| 别名变体 | 天空资源、天空采集接口 |
| 接口类型 | 苹果CMS V10标准采集接口 |
| 数据格式 | JSON与XML双格式输出 |
| 常见资源形态 | m3u8切片直链为主 |
| 适用CMS | 苹果CMS V10（maccms10）及同类兼容程序 |
| 更新频率评价 | 更新规律性较强，适合定时任务跟采 |
| 资源清晰度评价 | 以高清标注居多，实际画质仍需抽样确认 |
接口地址格式
天空资源网的接口基础路径同样写作 http://你的域名/api.php/provide/vod/ 的形态，具体地址以资源方文档页面公布为准。借助其齐全的文档，建议按"先小样、后批量"的顺序接入：先用ac=list取一小页数据确认字段结构，再做一次关键词请求验证检索可用性，最后才配置批量与定时任务。长期的采集量波动可用苹果CMS站点监控：采集量与收录数据看板搭建中的思路持续观察。格式示例如下。
http://你的域名/api.php/provide/vod/?ac=listhttp://你的域名/api.php/provide/vod/?ac=list&h=24http://你的域名/api.php/provide/vod/?ac=detail&ids=1参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 接口动作，list为列表、detail为详情 | ac=list |
| at | 格式参数，指定xml时返回XML文档，缺省JSON | at=xml |
| wd | 搜索参数，按片名关键词匹配站内数据 | wd=示例 |
| pg | 分页参数，控制返回列表的页码 | pg=2 |
| h | 时效参数，筛选最近N小时更新的条目 | h=24 |
| t | 类目参数，限定单一分类输出 | t=1 |
| ids | 编号参数，配合detail取指定影片，逗号分隔 | ids=5,7 |
配置要点
- 文档先行：接入前通读资源方文档中的参数说明与注意事项，把可用参数整理成清单再动手配置。
- 小样验证：首轮只取一两页数据，逐项核对片名、分类与播放地址是否齐全，确认无误后再放量。
- 参数留档：把验证通过的参数组合写进站内交接文档，后续换人维护也能照单复现。
- 定时跟采：该源更新规律性较强，定时任务按固定间隔执行即可覆盖绝大多数增量，无需高频轮询。
- 监控留痕：在采集日志中记录每轮条数与耗时，出现异常波动时便于快速回溯定位。
常见问题
文档里写的参数，实际请求后却返回空数据，问题出在哪？
先确认参数取值是否在文档允许范围内，再检查参数之间是否存在互斥，例如详情与分类筛选同时使用时部分源会忽略其一。若单独请求基础路径能返回数据，基本可判定为参数组合问题而非接口不可用。
中文关键词直接拼在地址里可行吗？
格式示例中可以这么写，但正式采集时建议对关键词做URL编码后再拼接，部分服务端对未编码的中文参数处理不稳定。若编码后仍无结果，可换用更短的关键词逐步缩小范围排查。
怎样判断接口是临时抖动还是长期不可用？
在不同时段各发一次最小请求，连续多轮都失败再考虑长期不可用；偶发失败多半是网络抖动或服务端瞬时压力。把每轮请求结果记入日志，两天以上的数据足以支撑判断，避免因一次失败就仓促更换采集源。