接口地址格式说明：JSON TXT m3u 各长什么样

为什么要懂格式

你不需要自己写接口格式，但知道格式长什么样，就能快速判断一个接口地址是否靠谱——如果一个 JSON 接口返回的不是 JSON、一个 m3u 返回的不是播放列表，那这个接口肯定用不了。

JSON 接口（点播源）

最常见的点播源格式。返回值是一个大 JSON 对象，包含分类列表和接口地址。简化示例：

{
  "sources": [
    {
      "name": "某影视源",
      "api": "https://example.com/api.php",
      "type": 1,
      "key": "video"
    }
  ]
}

关键字段：

字段	含义
`name`	源的显示名称（在接口列表里会看到）
`api`	实际的数据接口地址
`type`	源类型：1=JSON 接口、2=爬虫/采集、3=聚合
`key`	视频播放地址的字段名（不同源可能不一样）

有些接口会嵌套多层，不同源的字段名也可能不同——但 TVBox 会根据内置规则自动适配，一般不需要用户关心字段细节。

TXT 列表接口

有些源用纯文本格式列出多个子接口地址，每行一个：

https://api.source1.com/tv.json
https://api.source2.com/index.php?key=abc
https://pastebin.com/raw/xxxxx

TVBox 会自动识别这种格式并逐行加载。

m3u / m3u8 直播源

标准 IPTV 播放列表格式，纯文本：

#EXTM3U
#EXTINF:-1,央视一套
http://stream.example.com/cctv1.m3u8
#EXTINF:-1,湖南卫视
http://stream.example.com/hunan.m3u8
#EXTINF:-1,Discovery
http://stream.example.com/discovery.m3u8

规则：

#EXTM3U 是文件头（必须有）；
#EXTINF:-1,频道名称 定义一个频道（逗号后面是频道名）；
紧接着下一行是该频道的流媒体地址。

可以包含几百个频道，每个频道一组两行。

怎么验证接口能不能用

最简单的验证方法：

在电脑或手机浏览器里打开接口 URL；
如果返回的是：

JSON 接口 → 看到一大段 JSON 文本（可能被格式化工具渲染成可折叠结构） → 正常；
m3u 接口 → 看到 #EXTM3U 开头的纯文本 → 正常；
404 / 空页面 / HTML 错误页 → 接口挂了，换一个。

知道格式了，继续看m3u 直播源的完整接入步骤——直播源的配置和点播源略有不同。