如何通过Shopify Admin API指定返回特定产品字段并高效处理？

我基于Shopify Admin API编写了一段获取产品的后端代码，代码可正常运行，但Shopify返回的products数组包含大量嵌套属性，冗余数据过多。我希望能仅请求特定属性（如title、price等），同时寻求高效遍历处理这些产品数据的方法。

现有代码 #

export const getProducts = expressAsyncHandler(async (req: express.Request, res: express.Response) => {
    try {
        const response = await axios.get(`${BASE_URL}/products.json`, {
            headers: {
                "X-Shopify-Access-Token": ACCESS_TOKEN,
            }
        });
        const products = response.data; //.products;
        res.json(products);
        
    } catch (error) {
        throw new CustomAppError(500, error)
    }
});

返回数据示例（部分） #

{
    "products": [
        {
            "id": 6114761277630,
            "title": "2-Ply Gilead Facemask - Millitary Green / Print",
            "body_html": "<p data-mce-fragment=\"1\">Made in Kenya.<br data-mce-fragment=\"1\"></p>\n<p data-mce-fragment=\"1\">Wholesale and bulk order prices available on request for quantities over 10 pieces.&nbsp;</p>\n<p data-mce-fragment=\"1\">Call 0740821990 for more details.&nbsp;</p>",
            "vendor": "UHURU MARKET",
            "variants": [
                {
                    "id": 37678735687870,
                    "product_id": 6114761277630,
                    "title": "MILLITARY GREEN / F / UM00309",
                    "price": "9.00",
                    // 其他冗余属性...
                }
            ]
        }
    ]
}

1. 直接请求特定属性（推荐） #

Shopify Admin API支持通过fieldsURL参数指定返回字段，从源头减少冗余数据，比获取全量数据后再过滤更高效。

参数规则 #

• 顶级字段用逗号分隔，如id,title
• 嵌套字段用括号包裹子字段，如variants(id,price)表示仅返回变体中的id和price

示例请求URL #

`${BASE_URL}/products.json?fields=id,title,variants(id,price)`

2. 高效遍历处理数据 #

如果无法通过API参数过滤（比如需要保留原始数据做后续处理），可以用数组map方法快速提取目标属性，这是JS/TS中性能最优的数组遍历方式之一。

修改后的完整代码 #

export const getProducts = expressAsyncHandler(async (req: express.Request, res: express.Response) => {
    try {
        // 方式一：API层面过滤字段（优先推荐）
        const response = await axios.get(`${BASE_URL}/products.json?fields=id,title,variants(id,price)`, {
            headers: {
                "X-Shopify-Access-Token": ACCESS_TOKEN,
            }
        });

        // 方式二：本地处理全量数据（按需启用）
        // const simplifiedProducts = response.data.products.map(product => ({
        //     id: product.id,
        //     title: product.title,
        //     variants: product.variants.map(variant => ({
        //         id: variant.id,
        //         price: variant.price
        //     }))
        // }));

        // 返回API过滤后的结果，或本地处理后的simplifiedProducts
        res.json(response.data);
        // res.json({ products: simplifiedProducts });
        
    } catch (error) {
        throw new CustomAppError(500, error)
    }
});

说明 #

• 方式一能减少网络传输数据量，降低API响应时间和后端处理压力，优先使用
• 方式二使用map做线性遍历，代码简洁且性能优于嵌套for循环，适合需要二次加工数据的场景

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