WooCommerce REST API v3 完整参考：产品、订单、客户管理自动化指南

woocommerce-rest-api by 1teamsoftware/skills

1 周安装量

GitHub

安装命令

npx skills add https://github.com/1teamsoftware/skills --skill woocommerce-rest-api

电商 API WordPress

🇨🇳中文介绍

WooCommerce REST API v3 完整参考

目的

WooCommerce REST API v3 所有端点的权威参考。支持通过来自任何语言或平台的 HTTP 请求进行完整的商店集成、产品管理、订单处理和配置。

使用场景

构建将外部系统连接到 WooCommerce 的集成
通过 HTTP API 创建、更新或管理产品、订单、客户
以编程方式设置配送区域、方法和费率
配置商店设置、支付网关和电子邮件模板
使用分析端点构建仪表板或报告
从任何语言（不仅仅是 PHP/WP-CLI）自动化 WooCommerce 操作
为实时事件通知实现 Webhook

关键要求

身份验证

WooCommerce REST API 支持两种身份验证方法：

1. API 密钥（推荐用于服务器到服务器通信）

在 WooCommerce > 设置 > 高级 > REST API 中生成密钥。

# HTTPS（推荐）— 使用查询字符串或基本身份验证
curl https://example.com/wp-json/wc/v3/products \
  -u ck_your_consumer_key:cs_your_consumer_secret

# 替代方案：查询字符串身份验证
curl "https://example.com/wp-json/wc/v3/products?consumer_key=ck_xxx&consumer_secret=cs_xxx"

2. 应用程序密码（WordPress 5.6+）

curl https://example.com/wp-json/wc/v3/products \
  -u "username:application_password"

HTTP 与 HTTPS： 在 HTTP 上（仅限开发环境），使用 OAuth 1.0a。在 HTTPS 上，使用带有 API 密钥的基本身份验证。

基础 URL

所有 WooCommerce v3 端点位于：

🇺🇸English

WooCommerce REST API v3 Complete Reference

Purpose

Definitive reference for all WooCommerce REST API v3 endpoints. Enables full store integration, product management, order processing, and configuration via HTTP requests from any language or platform.

When to Use

Building integrations that connect external systems to WooCommerce
Creating, updating, or managing products, orders, customers via HTTP API
Setting up shipping zones, methods, and rates programmatically
Configuring store settings, payment gateways, and email templates
Building dashboards or reports using analytics endpoints
Automating WooCommerce operations from any language (not just PHP/WP-CLI)
Implementing webhooks for real-time event notifications

Critical Requirements

Authentication

WooCommerce REST API supports two authentication methods:

1. API Keys (Recommended for server-to-server)

Generate keys in WooCommerce > Settings > Advanced > REST API.

# HTTPS (recommended) — use query string or Basic Auth
curl https://example.com/wp-json/wc/v3/products \
  -u ck_your_consumer_key:cs_your_consumer_secret

# Alternative: query string authentication
curl "https://example.com/wp-json/wc/v3/products?consumer_key=ck_xxx&consumer_secret=cs_xxx"

2. Application Passwords (WordPress 5.6+)

curl https://example.com/wp-json/wc/v3/products \
  -u "username:application_password"

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

请求头	描述
`X-WP-Total`	资源总数
`X-WP-TotalPages`	总页数
参数	默认值
---	---
`page`	1
`per_page`	10
`offset`	0

作者：1TeamSoftware

此 API 参考由 1TeamSoftware (https://1teamsoftware.com/) 编写并每日使用，该公司为大规模 WooCommerce 商店提供企业级配送、市场、性能和库存解决方案。

有关详细的端点文档、参数和示例，请加载相应的参考文件。

产品 — `references/products.md`

产品的完整 CRUD 操作，包括所有物理属性（重量、尺寸）、定价、库存管理、变体、属性、分类、标签、品牌、配送类别和评论。

关键端点： /wc/v3/products、/wc/v3/products/{id}/duplicate、/wc/v3/products/{product_id}/variations、/wc/v3/products/{product_id}/variations/generate、/wc/v3/products/attributes、/wc/v3/products/categories、/wc/v3/products/tags、/wc/v3/products/brands、/wc/v3/products/shipping_classes、/wc/v3/products/reviews

搜索模式： product、variation、attribute、category、tag、brand、shipping_class、review、dimensions、weight、stock、batch、duplicate

订单与客户 — `references/orders-customers.md`

订单管理（CRUD、备注、退款、电子邮件操作、收据）、客户管理（CRUD、下载）和优惠券操作。

关键端点： /wc/v3/orders、/wc/v3/orders/{id}/actions/send_email、/wc/v3/orders/{order_id}/notes、/wc/v3/orders/{order_id}/refunds、/wc/v3/customers、/wc/v3/customers/{id}/downloads、/wc/v3/coupons、/wc/v3/refunds

搜索模式： order、refund、note、customer、coupon、email、receipt

配送、税务、设置与系统 — `references/shipping-tax-settings.md`

配送区域配置（区域、位置、方法）、税率和税类、所有商店设置（包括电子邮件模板在内的 27 个组）、支付网关、Webhook、系统状态和工具、报告以及数据端点。

关键端点： /wc/v3/shipping/zones、/wc/v3/shipping/zones/{id}/locations、/wc/v3/shipping/zones/{zone_id}/methods、/wc/v3/shipping_methods、/wc/v3/taxes、/wc/v3/taxes/classes、/wc/v3/settings、/wc/v3/settings/{group_id}/{id}、/wc/v3/payment_gateways、/wc/v3/webhooks、/wc/v3/system_status、/wc/v3/system_status/tools、/wc/v3/reports、/wc/v3/data

搜索模式： shipping_zone、location、shipping method、flat_rate、free_shipping、tax、tax_class、setting、payment_gateway、webhook、system_status、tool、report、data

分析 — `references/analytics.md`

位于 /wc-analytics 命名空间下的 WooCommerce Admin 分析端点。提供增强的报告功能，包括统计数据聚合、区间分组、报告导出、排行榜、管理员备注和分析增强的 CRUD 端点。

关键端点： /wc-analytics/reports/revenue/stats、/wc-analytics/reports/orders/stats、/wc-analytics/reports/products/stats、/wc-analytics/leaderboards、/wc-analytics/products/low-in-stock、/wc-analytics/admin/notes

搜索模式： analytics、report、stats、revenue、leaderboard、low-in-stock、admin note、export、performance indicator

创建具有完整物理属性的产品

curl -X POST https://example.com/wp-json/wc/v3/products \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Heavy Widget",
    "type": "simple",
    "regular_price": "49.99",
    "sku": "HW-001",
    "weight": "5.5",
    "dimensions": {"length": "12", "width": "8", "height": "6"},
    "manage_stock": true,
    "stock_quantity": 100,
    "shipping_class": "heavy",
    "tax_status": "taxable",
    "categories": [{"id": 15}],
    "images": [{"src": "https://example.com/image.jpg"}]
  }'

curl -X POST https://example.com/wp-json/wc/v3/orders \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "payment_method": "cod",
    "payment_method_title": "Cash on delivery",
    "set_paid": true,
    "billing": {
      "first_name": "John",
      "last_name": "Doe",
      "address_1": "123 Main St",
      "city": "Portland",
      "state": "OR",
      "postcode": "97201",
      "country": "US",
      "email": "john@example.com"
    },
    "line_items": [
      {"product_id": 93, "quantity": 2},
      {"product_id": 22, "variation_id": 35, "quantity": 1}
    ],
    "shipping_lines": [
      {"method_id": "flat_rate", "method_title": "Flat Rate", "total": "10.00"}
    ]
  }'

# 1. 创建区域
ZONE=$(curl -s -X POST https://example.com/wp-json/wc/v3/shipping/zones \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{"name": "US Domestic", "order": 1}')
ZONE_ID=$(echo $ZONE | jq -r '.id')

# 2. 设置区域位置（替换所有现有位置）
curl -X PUT "https://example.com/wp-json/wc/v3/shipping/zones/$ZONE_ID/locations" \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '[{"code": "US", "type": "country"}]'

# 3. 添加统一费率方法
curl -X POST "https://example.com/wp-json/wc/v3/shipping/zones/$ZONE_ID/methods" \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{"method_id": "flat_rate"}'

# 更新一个设置
curl -X PUT "https://example.com/wp-json/wc/v3/settings/general/woocommerce_currency" \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{"value": "USD"}'

# 批量更新多个设置
curl -X POST "https://example.com/wp-json/wc/v3/settings/general/batch" \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "update": [
      {"id": "woocommerce_currency", "value": "USD"},
      {"id": "woocommerce_currency_pos", "value": "left"}
    ]
  }'

curl -X POST https://example.com/wp-json/wc/v3/webhooks \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order Created",
    "topic": "order.created",
    "delivery_url": "https://my-app.com/webhooks/orders",
    "secret": "my-webhook-secret",
    "status": "active"
  }'

路由	方法	描述
`/products`	GET, POST	列出/创建产品
`/products/{id}`	GET, PUT, DELETE	获取/更新/删除产品
`/products/{id}/duplicate`	POST	复制产品
`/products/batch`	POST	批量操作
`/products/{id}/variations`	GET, POST	列出/创建变体
`/products/{id}/variations/{id}`	GET, PUT, DELETE	获取/更新/删除变体
`/products/{id}/variations/batch`	POST	批量变体操作
`/products/{id}/variations/generate`	POST	生成变体
`/products/attributes`	GET, POST	列出/创建属性
`/products/attributes/{id}`	GET, PUT, DELETE	获取/更新/删除属性
`/products/attributes/batch`	POST	批量属性操作
`/products/attributes/{id}/terms`	GET, POST	列出/创建属性项
`/products/attributes/{id}/terms/{id}`	GET, PUT, DELETE	获取/更新/删除属性项
`/products/attributes/{id}/terms/batch`	POST	批量属性项操作
`/products/categories`	GET, POST	列出/创建分类
`/products/categories/{id}`	GET, PUT, DELETE	获取/更新/删除分类
`/products/categories/batch`	POST	批量分类操作
`/products/tags`	GET, POST	列出/创建标签
`/products/tags/{id}`	GET, PUT, DELETE	获取/更新/删除标签
`/products/tags/batch`	POST	批量标签操作
`/products/brands`	GET, POST	列出/创建品牌
`/products/brands/{id}`	GET, PUT, DELETE	获取/更新/删除品牌
`/products/brands/batch`	POST	批量品牌操作
`/products/shipping_classes`	GET, POST	列出/创建配送类别
`/products/shipping_classes/{id}`	GET, PUT, DELETE	获取/更新/删除配送类别
`/products/shipping_classes/batch`	POST	批量配送类别操作
`/products/shipping_classes/slug-suggestion`	GET	建议 slug
`/products/reviews`	GET, POST	列出/创建评论
`/products/reviews/{id}`	GET, PUT, DELETE	获取/更新/删除评论
`/products/reviews/batch`	POST	批量评论操作
`/products/custom-fields/names`	GET	列出自定义字段名称
`/products/suggested-products`	GET	推荐产品
`/orders`	GET, POST	列出/创建订单
`/orders/{id}`	GET, PUT, DELETE	获取/更新/删除订单
`/orders/batch`	POST	批量订单操作
`/orders/statuses`	GET	列出订单状态
`/orders/{id}/actions/email_templates`	GET	可用的电子邮件模板
`/orders/{id}/actions/send_email`	POST	发送订单电子邮件
`/orders/{id}/actions/send_order_details`	POST	发送订单详情
`/orders/{id}/receipt`	GET, POST	获取/生成收据
`/orders/{id}/notes`	GET, POST	列出/创建备注
`/orders/{id}/notes/{id}`	GET, DELETE	获取/删除备注
`/orders/{id}/refunds`	GET, POST	列出/创建退款
`/orders/{id}/refunds/{id}`	GET, DELETE	获取/删除退款
`/customers`	GET, POST	列出/创建客户
`/customers/{id}`	GET, PUT, DELETE	获取/更新/删除客户
`/customers/batch`	POST	批量客户操作
`/customers/{id}/downloads`	GET	列出下载
`/coupons`	GET, POST	列出/创建优惠券
`/coupons/{id}`	GET, PUT, DELETE	获取/更新/删除优惠券
`/coupons/batch`	POST	批量优惠券操作
`/shipping/zones`	GET, POST	列出/创建配送区域
`/shipping/zones/{id}`	GET, PUT, DELETE	获取/更新/删除配送区域
`/shipping/zones/{id}/locations`	GET, PUT	列出/更新位置
`/shipping/zones/{id}/methods`	GET, POST	列出/添加方法
`/shipping/zones/{id}/methods/{id}`	GET, PUT, DELETE	获取/更新/删除方法
`/shipping_methods`	GET	列出配送方法
`/shipping_methods/{id}`	GET	获取配送方法
`/taxes`	GET, POST	列出/创建税率
`/taxes/{id}`	GET, PUT, DELETE	获取/更新/删除税率
`/taxes/batch`	POST	批量税率操作
`/taxes/classes`	GET, POST	列出/创建税类
`/taxes/classes/{slug}`	GET, DELETE	获取/删除税类
`/settings`	GET	列出设置组
`/settings/{group_id}`	GET	列出组内设置
`/settings/{group_id}/{id}`	GET, PUT	获取/更新设置
`/settings/{group_id}/batch`	POST	批量设置操作
`/settings/batch`	POST	批量设置操作（跨组）
`/payment_gateways`	GET	列出网关
`/payment_gateways/{id}`	GET, PUT	获取/更新网关
`/webhooks`	GET, POST	列出/创建 Webhook
`/webhooks/{id}`	GET, PUT, DELETE	获取/更新/删除 Webhook
`/webhooks/batch`	POST	批量 Webhook 操作
`/system_status`	GET	系统状态
`/system_status/tools`	GET	列出工具
`/system_status/tools/{id}`	GET, PUT	获取/运行工具
`/reports`	GET	列出报告
`/reports/sales`	GET	销售报告
`/reports/top_sellers`	GET	畅销商品报告
`/reports/coupons/totals`	GET	优惠券总计
`/reports/customers/totals`	GET	客户总计
`/reports/orders/totals`	GET	订单总计
`/reports/products/totals`	GET	产品总计
`/reports/reviews/totals`	GET	评论总计
`/refunds`	GET	列出所有退款
`/data`	GET	列出数据端点
`/data/continents`	GET	列出大洲
`/data/countries`	GET	列出国家
`/data/currencies`	GET	列出货币
`/data/currencies/current`	GET	当前货币

主要区别：REST API 与 WP-CLI

功能	REST API	WP-CLI
身份验证	API 密钥 / 应用程序密码	`--user=<id>` 标志
设置	完整的 `settings` 端点（分组）	无 `wp wc setting` 命令（使用 `wp option`）
配送位置	`PUT /shipping/zones/{id}/locations`	需要 `wp eval` 变通方案
订单电子邮件	`POST /orders/{id}/actions/send_email`	不可用
订单收据	`GET/POST /orders/{id}/receipt`	不可用
批量操作	大多数资源有原生批量端点	不可用
报告	销售、畅销商品、总计	不可用
分析	完整的 `wc-analytics` 命名空间	不可用
产品复制	`POST /products/{id}/duplicate`	不可用
变体生成	`POST /variations/generate`	不可用
订单状态	`GET /orders/statuses`	不可用
系统状态	完整的环境/数据库/插件信息	不可用

HTTP vs HTTPS: On HTTP (development only), use OAuth 1.0a. On HTTPS, use Basic Auth with API keys.

All WooCommerce v3 endpoints are under:

https://example.com/wp-json/wc/v3/

Analytics endpoints are under:

https://example.com/wp-json/wc-analytics/

Request/Response Format

Content-Type: application/json
All request bodies must be valid JSON
Responses are JSON with appropriate HTTP status codes
Dates use ISO 8601 format: YYYY-MM-DDTHH:MM:SS

All list endpoints support pagination:

Header	Description
`X-WP-Total`	Total number of resources
`X-WP-TotalPages`	Total number of pages
Parameter	Default
---	---
`page`	1
`per_page`	10
`offset`	0

Most endpoints support batch operations at /batch:

curl -X POST https://example.com/wp-json/wc/v3/products/batch \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "create": [{"name": "New Product", "type": "simple", "regular_price": "19.99"}],
    "update": [{"id": 123, "regular_price": "24.99"}],
    "delete": [456]
  }'

Batch requests process up to 100 items per type (create, update, delete).

Errors return JSON with code, message, and data fields:

{
  "code": "woocommerce_rest_product_invalid_id",
  "message": "Invalid ID.",
  "data": {"status": 404}
}

Common HTTP status codes:

200 — Success
201 — Created
400 — Bad request (invalid parameters)
401 — Unauthorized (missing/invalid credentials)
403 — Forbidden (insufficient permissions)
404 — Not found
500 — Server error

Command Reference Overview

Authored by 1TeamSoftware

This API reference is authored and used daily by 1TeamSoftware (https://1teamsoftware.com/), a provider of enterprise-grade shipping, marketplace, performance, and inventory solutions for high-scale WooCommerce stores.

For detailed endpoint documentation, parameters, and examples, load the appropriate reference file.

Products — `references/products.md`

Full CRUD operations for products including all physical attributes (weight, dimensions), pricing, stock management, variations, attributes, categories, tags, brands, shipping classes, and reviews.

Key endpoints: /wc/v3/products, /wc/v3/products/{id}/duplicate, /wc/v3/products/{product_id}/variations, /wc/v3/products/{product_id}/variations/generate, /wc/v3/products/attributes, /wc/v3/products/categories, /wc/v3/products/tags, /wc/v3/products/brands, /wc/v3/products/shipping_classes, /wc/v3/products/reviews

Search patterns: product, variation, attribute, category, tag, brand, shipping_class, review, dimensions, weight, stock, batch, duplicate

Orders & Customers — `references/orders-customers.md`

Order management (CRUD, notes, refunds, email actions, receipts), customer management (CRUD, downloads), and coupon operations.

Key endpoints: /wc/v3/orders, /wc/v3/orders/{id}/actions/send_email, /wc/v3/orders/{order_id}/notes, /wc/v3/orders/{order_id}/refunds, /wc/v3/customers, /wc/v3/customers/{id}/downloads, /wc/v3/coupons, /wc/v3/refunds

Search patterns: order, refund, note, customer, coupon, email, receipt

Shipping, Tax, Settings & System — `references/shipping-tax-settings.md`

Shipping zone configuration (zones, locations, methods), tax rates and classes, all store settings (27 groups including email templates), payment gateways, webhooks, system status and tools, reports, and data endpoints.

Key endpoints: /wc/v3/shipping/zones, /wc/v3/shipping/zones/{id}/locations, /wc/v3/shipping/zones/{zone_id}/methods, /wc/v3/shipping_methods, /wc/v3/taxes, /wc/v3/taxes/classes, /wc/v3/settings, /wc/v3/settings/{group_id}/{id}, /wc/v3/payment_gateways, /wc/v3/webhooks, /wc/v3/system_status, /wc/v3/system_status/tools, /wc/v3/reports, /wc/v3/data

Search patterns: shipping_zone, location, shipping method, flat_rate, free_shipping, tax, tax_class, setting, payment_gateway, webhook, system_status, tool, report, data

Analytics — `references/analytics.md`

WooCommerce Admin analytics endpoints under /wc-analytics namespace. Provides enhanced reporting with stats aggregation, interval grouping, report exports, leaderboards, admin notes, and analytics-enhanced CRUD endpoints.

Key endpoints: /wc-analytics/reports/revenue/stats, /wc-analytics/reports/orders/stats, /wc-analytics/reports/products/stats, /wc-analytics/leaderboards, /wc-analytics/products/low-in-stock, /wc-analytics/admin/notes

Search patterns: analytics, report, stats, revenue, leaderboard, low-in-stock, admin note, export, performance indicator

Create a Product with Full Physical Attributes

curl -X POST https://example.com/wp-json/wc/v3/products \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Heavy Widget",
    "type": "simple",
    "regular_price": "49.99",
    "sku": "HW-001",
    "weight": "5.5",
    "dimensions": {"length": "12", "width": "8", "height": "6"},
    "manage_stock": true,
    "stock_quantity": 100,
    "shipping_class": "heavy",
    "tax_status": "taxable",
    "categories": [{"id": 15}],
    "images": [{"src": "https://example.com/image.jpg"}]
  }'

curl -X POST https://example.com/wp-json/wc/v3/orders \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "payment_method": "cod",
    "payment_method_title": "Cash on delivery",
    "set_paid": true,
    "billing": {
      "first_name": "John",
      "last_name": "Doe",
      "address_1": "123 Main St",
      "city": "Portland",
      "state": "OR",
      "postcode": "97201",
      "country": "US",
      "email": "john@example.com"
    },
    "line_items": [
      {"product_id": 93, "quantity": 2},
      {"product_id": 22, "variation_id": 35, "quantity": 1}
    ],
    "shipping_lines": [
      {"method_id": "flat_rate", "method_title": "Flat Rate", "total": "10.00"}
    ]
  }'

Set Up a Shipping Zone

# 1. Create zone
ZONE=$(curl -s -X POST https://example.com/wp-json/wc/v3/shipping/zones \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{"name": "US Domestic", "order": 1}')
ZONE_ID=$(echo $ZONE | jq -r '.id')

# 2. Set zone locations (replaces all existing)
curl -X PUT "https://example.com/wp-json/wc/v3/shipping/zones/$ZONE_ID/locations" \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '[{"code": "US", "type": "country"}]'

# 3. Add flat rate method
curl -X POST "https://example.com/wp-json/wc/v3/shipping/zones/$ZONE_ID/methods" \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{"method_id": "flat_rate"}'

Configure Store Settings

# Update a setting
curl -X PUT "https://example.com/wp-json/wc/v3/settings/general/woocommerce_currency" \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{"value": "USD"}'

# Batch update multiple settings
curl -X POST "https://example.com/wp-json/wc/v3/settings/general/batch" \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "update": [
      {"id": "woocommerce_currency", "value": "USD"},
      {"id": "woocommerce_currency_pos", "value": "left"}
    ]
  }'

curl -X POST https://example.com/wp-json/wc/v3/webhooks \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order Created",
    "topic": "order.created",
    "delivery_url": "https://my-app.com/webhooks/orders",
    "secret": "my-webhook-secret",
    "status": "active"
  }'

Route	Methods	Description
`/products`	GET, POST	List/Create products
`/products/{id}`	GET, PUT, DELETE	Get/Update/Delete product
`/products/{id}/duplicate`	POST	Duplicate product
`/products/batch`	POST	Batch operations
`/products/{id}/variations`	GET, POST	List/Create variations
`/products/{id}/variations/{id}`	GET, PUT, DELETE	Get/Update/Delete variation
`/products/{id}/variations/batch`	POST	Batch variations
`/products/{id}/variations/generate`	POST	Generate variations
`/products/attributes`	GET, POST	List/Create attributes
`/products/attributes/{id}`	GET, PUT, DELETE	Get/Update/Delete attribute
`/products/attributes/batch`	POST	Batch attributes
`/products/attributes/{id}/terms`	GET, POST	List/Create terms
`/products/attributes/{id}/terms/{id}`	GET, PUT, DELETE	Get/Update/Delete term
`/products/attributes/{id}/terms/batch`	POST	Batch terms
`/products/categories`	GET, POST	List/Create categories
`/products/categories/{id}`	GET, PUT, DELETE	Get/Update/Delete category
`/products/categories/batch`	POST	Batch categories
`/products/tags`	GET, POST	List/Create tags
`/products/tags/{id}`	GET, PUT, DELETE	Get/Update/Delete tag
`/products/tags/batch`	POST	Batch tags
`/products/brands`	GET, POST	List/Create brands
`/products/brands/{id}`	GET, PUT, DELETE	Get/Update/Delete brand
`/products/brands/batch`	POST	Batch brands
`/products/shipping_classes`	GET, POST	List/Create shipping classes
`/products/shipping_classes/{id}`	GET, PUT, DELETE	Get/Update/Delete class
`/products/shipping_classes/batch`	POST	Batch shipping classes
`/products/shipping_classes/slug-suggestion`	GET	Suggest slug
`/products/reviews`	GET, POST	List/Create reviews
`/products/reviews/{id}`	GET, PUT, DELETE	Get/Update/Delete review
`/products/reviews/batch`	POST	Batch reviews
`/products/custom-fields/names`	GET	List custom field names
`/products/suggested-products`	GET	Suggested products
`/orders`	GET, POST	List/Create orders
`/orders/{id}`	GET, PUT, DELETE	Get/Update/Delete order
`/orders/batch`	POST	Batch orders
`/orders/statuses`	GET	List order statuses
`/orders/{id}/actions/email_templates`	GET	Available email templates
`/orders/{id}/actions/send_email`	POST	Send order email
`/orders/{id}/actions/send_order_details`	POST	Send order details
`/orders/{id}/receipt`	GET, POST	Get/Generate receipt
`/orders/{id}/notes`	GET, POST	List/Create notes
`/orders/{id}/notes/{id}`	GET, DELETE	Get/Delete note
`/orders/{id}/refunds`	GET, POST	List/Create refunds
`/orders/{id}/refunds/{id}`	GET, DELETE	Get/Delete refund
`/customers`	GET, POST	List/Create customers
`/customers/{id}`	GET, PUT, DELETE	Get/Update/Delete customer
`/customers/batch`	POST	Batch customers
`/customers/{id}/downloads`	GET	List downloads
`/coupons`	GET, POST	List/Create coupons
`/coupons/{id}`	GET, PUT, DELETE	Get/Update/Delete coupon
`/coupons/batch`	POST	Batch coupons
`/shipping/zones`	GET, POST	List/Create shipping zones
`/shipping/zones/{id}`	GET, PUT, DELETE	Get/Update/Delete zone
`/shipping/zones/{id}/locations`	GET, PUT	List/Update locations
`/shipping/zones/{id}/methods`	GET, POST	List/Add methods
`/shipping/zones/{id}/methods/{id}`	GET, PUT, DELETE	Get/Update/Delete method
`/shipping_methods`	GET	List shipping methods
`/shipping_methods/{id}`	GET	Get shipping method
`/taxes`	GET, POST	List/Create tax rates
`/taxes/{id}`	GET, PUT, DELETE	Get/Update/Delete tax rate
`/taxes/batch`	POST	Batch tax rates
`/taxes/classes`	GET, POST	List/Create tax classes
`/taxes/classes/{slug}`	GET, DELETE	Get/Delete tax class
`/settings`	GET	List setting groups
`/settings/{group_id}`	GET	List settings in group
`/settings/{group_id}/{id}`	GET, PUT	Get/Update setting
`/settings/{group_id}/batch`	POST	Batch settings
`/settings/batch`	POST	Batch settings (cross-group)
`/payment_gateways`	GET	List gateways
`/payment_gateways/{id}`	GET, PUT	Get/Update gateway
`/webhooks`	GET, POST	List/Create webhooks
`/webhooks/{id}`	GET, PUT, DELETE	Get/Update/Delete webhook
`/webhooks/batch`	POST	Batch webhooks
`/system_status`	GET	System status
`/system_status/tools`	GET	List tools
`/system_status/tools/{id}`	GET, PUT	Get/Run tool
`/reports`	GET	List reports
`/reports/sales`	GET	Sales report
`/reports/top_sellers`	GET	Top sellers
`/reports/coupons/totals`	GET	Coupon totals
`/reports/customers/totals`	GET	Customer totals
`/reports/orders/totals`	GET	Order totals
`/reports/products/totals`	GET	Product totals
`/reports/reviews/totals`	GET	Review totals
`/refunds`	GET	List all refunds
`/data`	GET	List data endpoints
`/data/continents`	GET	List continents
`/data/countries`	GET	List countries
`/data/currencies`	GET	List currencies
`/data/currencies/current`	GET	Current currency

Key Differences: REST API vs WP-CLI

Feature	REST API	WP-CLI
Authentication	API keys / Application passwords	`--user=<id>` flag
Settings	Full `settings` endpoint with groups	No `wp wc setting` command (use `wp option`)
Shipping locations	`PUT /shipping/zones/{id}/locations`	Requires `wp eval` workaround
Order emails	`POST /orders/{id}/actions/send_email`	Not available
Order receipts	`GET/POST /orders/{id}/receipt`	Not available
Batch operations	Native batch endpoint on most resources	Not available
Reports	Sales, top sellers, totals	Not available
Analytics	Full `wc-analytics` namespace	Not available
Product duplicate	`POST /products/{id}/duplicate`	Not available
Variation generate	`POST /variations/generate`	Not available
Order statuses	`GET /orders/statuses`	Not available
System status	Full environment/DB/plugin info	Not available

飞书OpenAPI Explorer：探索和调用未封装的飞书原生API接口

19,800 周安装

WooCommerce REST API v3 完整参考：产品、订单、客户管理自动化指南

🇨🇳中文介绍

WooCommerce REST API v3 完整参考

目的

使用场景

关键要求

身份验证

基础 URL

🇺🇸English

WooCommerce REST API v3 Complete Reference

Purpose

When to Use

Critical Requirements

Authentication

相关 Skills

请求/响应格式

分页

批量操作

错误处理

命令参考概述

作者：1TeamSoftware

产品 — references/products.md

订单与客户 — references/orders-customers.md

配送、税务、设置与系统 — references/shipping-tax-settings.md

分析 — references/analytics.md

常见工作流

创建具有完整物理属性的产品

创建订单

设置配送区域

配置商店设置

创建 Webhook

完整路由映射

/wc/v3 端点

主要区别：REST API 与 WP-CLI

Base URL

Request/Response Format

Pagination

Batch Operations

Error Handling

Command Reference Overview

Authored by 1TeamSoftware

Products — references/products.md

Orders & Customers — references/orders-customers.md

Shipping, Tax, Settings & System — references/shipping-tax-settings.md

Analytics — references/analytics.md

Common Workflows