赞片CMSAPI文档

学完这篇，你能从零跑通赞片CMS的API：找到接口文档、开通接口权限、拿到 appid 和 appkey、成功调通第一个列表请求，并且知道报错时该看哪里。

第一步：确认版本，找到接口文档入口

这一步要做的是先定位你这套系统的文档地址，因为赞片CMS不同版本的菜单名和接口路径不完全一样，照着别的版本的路径找会白折腾。

先登录后台，地址一般是 http://你的域名/admin.php。登录后看左侧菜单，在「系统」或「应用」分组下找「接口管理」「API接口」「开放接口」这类名字——v3.x 常见叫「接口管理」，早期版本可能放在「扩展」里。点进去后页面右上角或底部通常有「接口文档」链接，点开就是官方给的参数表。

如果后台找不到入口，直接试这两个地址：http://你的域名/api.php 和 http://你的域名/index.php/api，很多版本会直接返回接口说明页。

注意：先在后台「系统设置 → 站点信息」里看一眼版本号，再去看对应版本的文档。跨版本抄参数是最常见的踩坑点。

第二步：开通接口并拿到 appid 与 appkey

这一步要拿到调用凭证，没有它后面的请求全部会被拒。

在「接口管理」页面点「添加接口」或「新建应用」，填三项：应用名称（自己看得懂就行，比如「主站对接」）、绑定域名（填调用方的域名，不带 http://，多个域名用英文逗号分隔）、有效期（填到期日期或选「永久」）。保存后系统会生成一对 appid（一串数字）和 appkey（一串32位字符）。

注意：appkey 通常只在创建时完整显示一次，刷新页面就变成星号了。当场复制到记事本，丢了只能删掉重建。

第三步：看懂三个核心接口

赞片CMS的对外接口基本围绕三个动作：取列表、取详情、取播放地址。文档里的参数名以你后台显示的为准，常见形式是：

• 列表：ac=list，配 t（分类ID）、pg（页码）、h（最近多少小时更新）、wd（搜索关键词）
• 详情：ac=detail，配 ids（影片ID，多个用逗号分隔）
• 播放：ac=play，配 id（影片ID）、sid（播放源序号）、nid（集数）

分类ID在后台「分类管理」里，鼠标悬停分类名时浏览器左下角或链接里能看到 id=数字，那个数字就是 t 的值。

第四步：发出第一个请求

这一步的目标是拿到一段正常的 JSON。

打开终端，把下面命令里的域名和密钥换成你自己的：

curl "http://你的域名/api.php?ac=list&t=1&pg=1&appid=你的appid&appkey=你的appkey"

返回内容应该是类似这样的结构：

{"code":1,"msg":"ok","page":1,"pagecount":20,"list":[
  {"vod_id":"123","vod_name":"影片名","vod_time":"2024-05-01 10:00:00"}
]}

看到 code 为 1 就说明通了。如果文档里要求签名，把 appkey 换成 sign 参数，sign 一般按 md5(appid + appkey + 时间戳) 生成，时间戳用 time 参数一起传，具体拼接顺序一定以你后台那份文档为准。

注意：参数值里有中文或特殊符号时，用 URL 编码处理，比如「流浪地球」要写成 %E6%B5%81%E6%B5%AA%E5%9C%B0%E7%90%83。直接用原始中文在部分服务器上会返回空列表。

第五步：按错误码排查

拿到 code 不为 1 时，对照文档里的错误码表：密钥类错误（常见 1001 或「appkey 错误」）说明 appid 和 appkey 不配对，重新复制一次；域名类错误（常见「域名未授权」）说明调用方域名和第二步填的绑定域名不一致，把 www 前缀、端口号都核一遍；签名类错误通常是时间戳过期，服务器时间偏差超过几分钟就会失败。

如果接口本身通了但数据是旧内容，去后台「系统 → 缓存管理」清一次缓存，赞片CMS的列表接口默认会读缓存。

小结

• 先看后台版本号，再找「接口管理」里的文档，不要跨版本抄参数
• 创建接口应用时绑定域名要写准，appkey 只显示一次，当场保存
• 核心就三个动作：列表 ac=list、详情 ac=detail、播放 ac=play
• 用 curl 先跑通 ac=list，确认 code 为 1 再写业务代码
• 报错先分三类：密钥、域名授权、签名时间戳，一一对应排查