如何通过WooCommerce API获取热销商品？v1版本调用遇参数错误

你遇到的rest_invalid_param错误核心原因很明确：WooCommerce API v1版本的products端点并不支持total_sales作为orderby的参数值——按销量排序的这个选项是在后续的v2及更高版本（比如当前主流的v3）才新增的。

下面给你两种可行的解决方案：

方案1：升级到WooCommerce API v3（推荐） #

WooCommerce API v1已经被官方废弃，不再提供维护和功能更新，直接升级到v3是最优选择，既能解决排序问题，还能获得更好的安全性和功能支持。调整后的请求如下：

• 请求地址改为：https://DOMAINNAME.com/wp-json/wc/v3/products
• 保留原有参数，orderby=total_sales在v3中完全有效，完整请求示例：

https://DOMAINNAME.com/wp-json/wc/v3/products?consumer_key=CONSUMER_KEY&consumer_secret=CONSUMER_SECRET&category=CATEGORY_ID&order=asc&orderby=total_sales

小提示：如果想获取销量从高到低的商品，把order=asc改成order=desc会更符合“热销”的需求。

方案2：在v1版本下手动实现排序（不推荐） #

如果因为特殊限制必须使用v1版本，你需要分两步操作：

1. 先调用v1的products端点获取目标分类下的所有商品，仅指定category参数：

https://DOMAINNAME.com/wp-json/wc/v1/products?consumer_key=CONSUMER_KEY&consumer_secret=CONSUMER_SECRET&category=CATEGORY_ID

2. 在你的代码中，从返回的商品数据里提取每个商品的total_sales字段，然后手动对商品列表按这个字段进行升序或降序排序。

另外补充一个小细节：你请求URL里的&是HTML转义后的符号，虽然多数HTTP客户端会自动处理，但手动构造URL时建议直接替换成&，避免潜在的解析问题。

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