采集与接口
站外入库与火车头
配置 MacCMS 站外入库开关、口令和分类映射，理解 receive 接口必要字段及失败码。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
Receive 接口会写入数据库。它与 provide 只读接口不同，启用前先在测试站备份并验证一条数据。
后台准备
进入「系统 → 站外入库配置」，开启所需功能，设置独立入库口令并配置分类映射。本版本要求口令至少16字符；不要使用后台登录密码。
视频最小字段
| 字段 | 说明 |
|---|---|
| pass | 本站入库口令，不公开在模板中 |
| vod_name | 视频名称，不能为空 |
| type_id | 本站视频分类 ID |
| type_name | 不传 type_id 时按映射转换；两者都有时以 ID 为准 |
目标为 /api.php/receive/vod。文章改 receive/art 并使用 art_name；其他模型也必须使用各自字段前缀。通过工具的 POST 表单配置提交，口令保存在本地配置，不写进公开 URL 或截图。
火车头配置顺序
- 使用与此版本匹配的发布模块，网站根地址按模块要求填写你的站点/api.php/。
- 配置入库口令和分类，先发布名称为「入库测试」的一条内容。
- 查看响应 code／msg，再到后台核对名称、分类、状态和图片。
- 再提交同一条数据，确认当前采集配置如何更新／去重，之后才批量发布。
失败码
| code | 检查 |
|---|---|
| 3001 | 接口未开启 |
| 3002 | 口令不符 |
| 3003 | 配置口令长度不足 |
| 2001 | 视频名称为空 |
| 2002 | 分类信息为空 |
请求200但 code 失败仍是未入库。成功也要核对数据字段，避免把外站分类 ID 当成本地 ID。