采集与接口
API V2 与统一搜索
了解新版 MacCMS API 的 PublicApi 开关、统一搜索、offset／limit 分页与旧 provide 格式的区别。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
API V2 文档描述新版模块接口；它不表示所有 URL 都带 /v2。不要把旧 provide 的 list／pagecount 格式套到 get_list 的 info.rows 上。
开启条件
后台 API 公开接口（PublicApi）设置控制模块公开访问。统一搜索还受站点搜索开关约束。鉴权接口按其控制器要求携带凭据，不能因为路径以 api.php 开头就假定匿名可用。
统一搜索示例
GET /api.php/search/index?wd=测试&module=all&limit=10&page=1| 参数 | 用法 |
|---|---|
| wd | 必填搜索词，最多50字 |
| module | all、vod、art、manga |
| limit | 每模型1–50条，默认10 |
| page | 页码，从1开始 |
成功返回 info 中的各模型结果。统一搜索列表字段使用 id、name、pic、link、module 等通用名称，与 vod_name 等数据库字段不同。搜索关闭可能返回 code=999；参数不合法可能为1001。
模块列表和联想
GET /api.php/vod/get_list/?offset=0&limit=10
GET /api.php/search/suggest?wd=测试&limit=5模块 get_list 常见结构为 info.offset、info.limit、info.total、info.rows。统一搜索 suggest 使用 info.list；每个接口要按自己的返回结构读取。
接入前检查
- 用一条已知数据验证名称、图片和详情链接。
- 验证关闭 PublicApi、空词、超限和无结果行为。
- 前端输入做防抖，限制分页；遇到错误显示 msg，不无限重试。
- 用户、支付或写入接口另核对认证、令牌与返回契约。
完整接口范围包括会员、内容模块、评论和其他功能，按下方当前版本接口文档逐项选用；不需要为了一个搜索框启用所有接口。