ASP.NET Core 7中HttpClient多参数调用Shopify API问题排查

问题根源 #

你当前的使用方式确实有误：Shopify官方API明确要求ids参数的值是逗号（,）分隔的产品ID列表，但你用了%77（对应ASCII字符w）作为分隔符，这不符合API的参数格式要求。API解析时只会识别第一个ID，后续内容因分隔符不合法被忽略，所以无论调换顺序都只返回首个ID的产品。

正确且优雅的参数传递方式 #

在.NET Core 7中使用HttpClient时，推荐通过内置工具类构建请求URL，避免手动拼接导致的编码错误或格式问题，以下是两种常用方案：

方案1：使用QueryHelpers构建查询字符串 #

利用ASP.NET Core内置的QueryHelpers.AddQueryString方法自动处理参数编码和拼接：

using Microsoft.AspNetCore.WebUtilities;

var baseUrl = "https://your-shop-name.myshopify.com/admin/api/2024-07/products.json";
var productIds = new List<long> { 123456, 789012, 345678 };

// 将ID列表转为逗号分隔的字符串
var idsValue = string.Join(",", productIds);
// 构建带查询参数的URL
var requestUrl = QueryHelpers.AddQueryString(baseUrl, new Dictionary<string, string>
{
    { "ids", idsValue }
});

// 发送请求
using var httpClient = new HttpClient();
// 记得添加Shopify认证头
httpClient.DefaultRequestHeaders.Add("X-Shopify-Access-Token", "your-access-token");
var response = await httpClient.GetAsync(requestUrl);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();

方案2：使用HttpRequestMessage构造请求 #

如果需要更精细控制请求细节，可以直接构造HttpRequestMessage并添加查询参数：

var baseUrl = new Uri("https://your-shop-name.myshopify.com/admin/api/2024-07/products.json");
var productIds = new List<long> { 123456, 789012, 345678 };
var idsValue = string.Join(",", productIds);

var request = new HttpRequestMessage(HttpMethod.Get, baseUrl);
// 安全编码并拼接参数
request.RequestUri = new Uri($"{baseUrl}?ids={Uri.EscapeDataString(idsValue)}");
// 添加认证头
request.Headers.Add("X-Shopify-Access-Token", "your-access-token");

using var httpClient = new HttpClient();
var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();

关键注意点 #

• 必须使用**逗号（,）**作为ID分隔符，不要替换为其他字符或错误的URL编码值；
• 若ID数量较多，需确认Shopify API对ids参数的长度限制，避免URL过长导致请求失败；
• 所有请求必须携带Shopify要求的认证信息，否则会返回权限错误。

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