如何通过REST API向现有WooCommerce订单添加订单项？

核心问题说明 #

你之前的操作存在两个关键错误：

1. POST请求用途错误：POST /wp-json/wc/v3/orders/{id} 是创建新订单的接口，而非更新现有订单，所以返回200但不会修改目标订单。
2. 不存在的子端点：WooCommerce REST API v3 没有/orders/{id}/line_items这个子资源接口，因此会返回404错误。

正确实现步骤 #

要给现有订单添加订单项，需通过PUT请求更新订单，同时完整传递包含新项的订单项数组（因为API会用请求体的line_items替换原有列表，所以必须保留原有项+添加新项）。

步骤1：获取现有订单的订单项

发送GET请求获取目标订单的现有订单项：

GET /wp-json/wc/v3/orders/7691?_fields=line_items

响应会返回类似这样的数组：

{
  "line_items": [
    {
      "id": 100,
      "product_id": 456,
      "quantity": 2,
      "name": "Existing Product",
      "subtotal": "20.00",
      "total": "20.00"
    }
  ]
}

步骤2：构造更新请求体

将现有订单项与要添加的新项合并到line_items数组中，新项需包含必填字段（product_id、quantity，建议补充name、subtotal、total以避免自动计算偏差）：

{
  "line_items": [
    // 原有订单项
    {
      "id": 100,
      "product_id": 456,
      "quantity": 2,
      "name": "Existing Product",
      "subtotal": "20.00",
      "total": "20.00"
    },
    // 新添加的订单项
    {
      "product_id": 123,
      "quantity": 1,
      "name": "Product Name",
      "subtotal": "10.00",
      "total": "10.00"
    }
  ]
}

步骤3：发送PUT更新请求

将构造好的请求体通过PUT请求发送到订单详情接口：

PUT /wp-json/wc/v3/orders/7691

请求成功后，返回的订单数据中会包含新增的订单项。

注意事项 #

• 确保API密钥拥有write_orders权限（你的授权已通过，但需确认权限范围）。
• 如果省略原有订单项，API会将订单的订单项替换为仅包含新项，导致原有数据丢失。
• 若不确定产品的subtotal和total，可以先查询产品详情接口获取价格，再填入请求体。

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