使用PHP curl调用Cockpit api/collections/save接口返回404错误如何解决

问题原因与修复方案 #

你遇到的问题由两个核心配置错误导致：

1. CURL请求头设置错误
   你代码中使用CURLOPT_HEADER配置请求头是完全错误的：CURLOPT_HEADER是布尔类型参数，作用是控制是否将响应头包含在返回结果中，要设置自定义请求头必须使用CURLOPT_HTTPHEADER参数，且参数格式要求是索引数组，每个元素为HeaderName: HeaderValue格式的字符串，不能传入关联数组。
   这个错误直接导致你提交的Content-Type: application/json没有实际发送到服务端，服务端无法识别请求体是JSON格式，不会自动解析，所以$this->param('data', null)只能拿到未解析的原始字符串，返回null。

2. 权限配置错误
   $this->module('cockpit')->getUser()返回false说明你的API密钥没有被正确识别，或者没有对应操作权限：

• 确认你使用的APP_TOKEN是Cockpit后台生成的API密钥，不是普通用户的登录token
• 确认该API密钥已经配置了collections.save操作的权限，且开放了trigocms集合的读写权限
• 部分版本的Cockpit权限校验不通过时会直接返回404状态码，而非403，符合你遇到的报错现象

修正后的代码 #

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, APP_URL . '/api/collections/save/trigocms?token=' . APP_TOKEN);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
// 修正请求头设置参数和格式
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['data' => $site]));
$output = curl_exec($ch);
// 可开启下方代码调试错误信息
// if(curl_errno($ch)) {
//     var_dump(curl_error($ch));
// }
curl_close($ch);

额外说明 #

你提交的$site数组格式符合Cockpit更新要求，只要携带正确的_id，不需要提交完整条目，仅传需要修改的字段即可实现增量更新，不会覆盖其他未提交的字段。
如果修改后仍出现404错误，可排查：

• APP_URL配置是否正确，末尾是否多了斜杠
• trigocms集合名拼写、大小写是否和后台配置完全一致
• 你使用的Cockpit版本是否调整了集合保存的API路径

内容的提问来源于stack exchange，提问作者ciekals11