WooCommerce REST API v3无法删除商品分类问题咨询

问题根源 #

你之前的两次尝试都没有触发删除逻辑：

• 第一次请求使用默认GET方法，仅用于查询分类数据，哪怕携带force=true参数也不会执行删除操作，返回200只是正常返回分类详情
• 第二次使用POST方法但没有告知API要执行删除动作，API仍然按照查询/更新逻辑处理

解决方法 #

WooCommerce基于WordPress REST API开发，原生支持HTTP请求方法覆盖，专门适配不支持DELETE、PUT等自定义请求方法的服务器，只需在POST请求中添加_method参数指定为DELETE即可触发删除逻辑。

适配不支持DELETE请求的修正代码 #

$consumer_key = "<consumer_key>";
$consumer_secret = "<consumer_secret>";
$catUrl = "https://www.example.com/wp-json/wc/v3/products/categories/";
$catId = 63;  // 待删除的分类ID

$url = $catUrl.$catId."?consumer_key=".$consumer_key."&consumer_secret=".$consumer_secret;

$data = array(
    "_method" => "DELETE", // 核心参数：覆盖请求方法为删除
    "force" => true
);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
$result = curl_exec($ch);

$response_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 校验删除结果
if(isJson($result)) {
    $res_data = json_decode($result,true);
    // 删除成功会返回deleted字段为true
    if(isset($res_data['deleted']) && $res_data['deleted'] === true) {
        echo "分类删除成功";
    }else{
        echo "删除失败，错误信息：".print_r($res_data,true);
    }
}

服务器支持DELETE请求的标准写法 #

如果服务器允许DELETE请求，直接指定请求方法为DELETE即可，写法更规范：

$consumer_key = "<consumer_key>";
$consumer_secret = "<consumer_secret>";
$catUrl = "https://www.example.com/wp-json/wc/v3/products/categories/";
$catId = 63;  // 待删除的分类ID

$url = $catUrl.$catId."?force=true&consumer_key=".$consumer_key."&consumer_secret=".$consumer_secret;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
$result = curl_exec($ch);

$response_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

注意事项 #

• 确认你创建的WooCommerce REST API密钥权限为读写，仅读权限无法执行删除操作
• 如果删除失败，可查看返回的JSON数据中的错误提示，常见问题包括分类ID不存在、权限不足、分类仍关联商品/子分类
• 部分安全插件或WAF防火墙会拦截_method参数或DELETE请求，可暂时禁用相关规则测试

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