如何通过WooCommerce API和Python获取随机商品？

你的代码报错是因为WooCommerce REST API 默认不支持orderby=rand——这个参数是WordPress原生查询的选项，但并未开放给REST API接口，所以直接传入会触发错误。下面提供几种可行的解决方法，按效率从高到低排序：

方法1：用offset+随机数实现（推荐） #

这种方法不用拉取所有商品数据，仅通过两次API请求就能拿到随机商品，适合商品数量较多的场景：

1. 先请求一次在售商品，通过响应头获取总数量
2. 生成一个0到「总数量-1」之间的随机数作为偏移量
3. 用这个偏移量请求单个商品

代码示例：

import random

# 获取在售商品总数量
wcapi.get('products', params={'stock_status': 'instock', 'per_page': 1})
total_instock = int(wcapi.headers['X-WP-Total'])

# 生成随机偏移量
random_offset = random.randint(0, total_instock - 1)

# 获取随机商品
random_product = wcapi.get('products', params={
    'stock_status': 'instock',
    'per_page': 1,
    'offset': random_offset
}).json()

方法2：获取所有商品ID后随机选择 #

如果商品数量不多（比如几百个以内），可以先拉取所有在售商品的ID，再随机挑选一个查询详情：

import random

all_instock_ids = []
current_page = 1

# 分页拉取所有在售商品ID（per_page最大为100）
while True:
    response = wcapi.get('products', params={
        'stock_status': 'instock',
        'per_page': 100,
        'page': current_page,
        '_fields': 'id'  # 只请求ID字段，减少数据传输
    }).json()
    
    if not response:
        break
    
    all_instock_ids.extend([item['id'] for item in response])
    current_page += 1

# 随机选择一个ID并获取商品详情
random_product_id = random.choice(all_instock_ids)
random_product = wcapi.get(f'products/{random_product_id}').json()

方法3：修改WordPress端代码启用rand排序 #

如果你有权限修改WordPress的代码，可以通过添加钩子开放rand排序选项，这样你原来的Python代码就能直接使用：

在主题的functions.php文件或自定义插件中添加以下PHP代码：

add_filter('woocommerce_rest_product_query', 'allow_rand_order_for_rest_api', 10, 2);
function allow_rand_order_for_rest_api($query_args, $request) {
    if (isset($request['orderby']) && $request['orderby'] === 'rand') {
        $query_args['orderby'] = 'rand';
    }
    return $query_args;
}

添加完成后，你最初的代码wcapi.get('products', params={'stock_status': 'instock', 'orderby' : 'rand', 'per_page' : 1}).json()就能正常返回随机商品了。

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