用途：通过 WooCommerce 版本化 REST API（/wp-json/wc/v3/）读写产品、订单、客户、优惠券和商店设置，用于无头前端、ERP/CRM/履约集成、订单管理看板、库存同步、批量商品导入或价格更新，以及移动应用访问商店数据。
认证与配置：在 WordPress 后台 WooCommerce → Settings → Advanced → REST API → Add Key 生成 Consumer Key（ck_）与 Consumer Secret（cs_），权限选 Read/Write。HTTPS 下用 Basic Auth，非 HTTPS 用 OAuth 1.0a。凭据应放入环境变量：WOOCOMMERCE_URL、WOOCOMMERCE_CONSUMER_KEY、WOOCOMMERCE_CONSUMER_SECRET，不要写入源码。安装客户端：npm install @woocommerce/woocommerce-rest-api。
主要能力：用客户端实例的 get/post/put 调用 products、orders、customers、coupons 等端点。产品支持分页、分类、状态、库存状态、排序过滤，可通过 x-wp-total 与 x-wp-totalpages 响应头取总数与总页数；订单支持创建、更新状态（pending、processing、on-hold、completed、cancelled、refunded）和添加订单备注；变体通过 products/{id}/variations 获取，可变商品下单时 line_items 必须带 variation_id。库存可更新 stock_quantity 并设置 manage_stock。批量更新用 products/batch，最多 100 条创建/更新/删除。
最佳实践与限制：始终使用 HTTPS；默认无速率限制，但高并发可能耗尽 PHP-FPM 或 MySQL，批量操作建议用 p-limit 或队列限流。用 _fields 参数裁剪响应字段，用 after/before 的 ISO 8601 时间戳做增量同步，基础 URL 不要带尾斜杠。错误码包括 rest_invalid_param、woocommerce_rest_cannot_create 等。常见问题：401 需检查 HTTPS 与认证方式；产品接口返回空数组需检查密钥对应用户的 woocommerce_manage_products 权限；分页响应头只在列表端点出现；批量响应需逐项检查 error 字段。API 密钥管理、具体限额与计费信息暂未提供。