实战指南：微店根据关键词取商品列表 API

微店的 item_search 接口是其开放平台提供的核心接口之一，主要用于根据关键词搜索商品列表。该接口适用于多种场景，包括店铺选品、竞品分析和电商聚合平台等。

核心功能

• 关键词搜索：通过商品标题、描述、属性等关键词进行搜索，返回符合条件的商品列表。

• 商品详情获取：提供商品 ID 对应的详细信息，包括价格、库存、图片、规格参数等。

• 排序与筛选：支持按价格、销量、评价等多种维度排序，以及根据品牌、类别等条件筛选。

• 分页处理：支持结果分页，便于处理大量数据，提高请求效率。

接口端点

• 正式环境：https://api.weidian.com/item/search

• 沙箱环境：https://sandbox.api.weidian.com/item/search（测试使用）

请求方式

仅支持 HTTP POST。

数据格式

请求与响应均为 JSON 格式。

认证方式

采用 appkey + signature 签名认证，无需令牌（Token）。

二、使用步骤

（一）注册与认证

1. 在微店开放平台注册账号，并完成实名认证（个人或企业均可）。

2. 提交 API 使用申请，等待审核通过并获得 API 调用权限。

（二）创建应用与获取密钥

1. 登录微店开放平台，创建应用以获取 API 凭证，如 App Key 和 App Secret。

2. 这些凭证是调用 API 接口所必需的，需要妥善保管。

（三）构建 HTTP 请求

根据 API 文档，构建包含必要参数的 HTTP 请求。请求通常包括 API 凭证（如 appKey 和 appSecret）、商品 ID（或关键词）、排序规则、分页参数等。

（四）发送请求

使用编程语言或工具（如 Python 的 requests 库、Java 的 HttpClient 等）发起 HTTP 请求。请求方法通常为 GET 或 POST，具体以 API 文档为准。

（五）处理响应

接收 API 返回的响应数据，通常为 JSON 格式。解析响应数据，提取出所需的商品详情数据。对响应数据进行必要的验证和处理，确保数据的完整性和准确性。

（六）异常处理

在调用接口时，可能会遇到网络问题或服务器返回错误状态码。建议使用 try-except 捕获异常，并记录错误信息以便后续处理。

（七）调用频率限制

为了保护服务器的稳定性和防止恶意请求，微店对商品详情 API 的调用频率是有限制的。开发者需要仔细阅读微店的开发者文档，了解并遵守相关的调用频率限制。

三、示例代码

（一）Python 示例代码

以下是一个使用 Python 调用微店商品详情关键词搜索 API 接口的示例代码：

import requests
import hashlib
import time
import random
import string

# 配置参数（替换为实际信息）
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
api_url = "https://api.weidian.com/item/search"

# 生成签名
def generate_sign(params, app_secret):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    query_string = app_secret
    for k, v in sorted_params:
        query_string += f"{k}{v}"
    query_string += app_secret
    return hashlib.md5(query_string.encode("utf-8")).hexdigest().upper()

# 搜索商品
def search_products(keyword, page=1, size=20, sort=1):
    params = {
        "app_key": app_key,
        "keyword": keyword,
        "page_no": page,
        "page_size": size,
        "sort_type": sort,
        "related_words": 1  # 开启语义扩展
    }
    params["sign"] = generate_sign(params, app_secret)
    headers = {"Content-Type": "application/json"}
    response = requests.post(api_url, json=params, headers=headers)
    if response.status_code == 200:
        return response.json()
    else:
        return {"error": response.status_code}

# 使用示例
result = search_products("女装", page=1, size=10, sort=2)
print(result)

（二）Java 示例代码

以下是一个使用 Java 调用微店商品详情关键词搜索 API 接口的示例代码：

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import com.alibaba.fastjson.JSONObject;
import java.util.*;
import java.net.URLEncoder;

public class WeidianSearchApi {
    private static final String APP_KEY = "YOUR_APP_KEY";
    private static final String APP_SECRET = "YOUR_APP_SECRET";
    private static final String API_URL = "https://api.weidian.com/item/search";

    public static void main(String[] args) throws Exception {
        String keyword = "女装";
        int page = 1;
        int size = 10;
        int sort = 2;

        Map<String, String> params = new TreeMap<>();
        params.put("app_key", APP_KEY);
        params.put("keyword", keyword);
        params.put("page_no", String.valueOf(page));
        params.put("page_size", String.valueOf(size));
        params.put("sort_type", String.valueOf(sort));
        params.put("related_words", "1");  // 开启语义扩展

        String sign = generateSign(params, APP_SECRET);
        params.put("sign", sign);

        StringBuilder urlBuilder = new StringBuilder(API_URL).append("?");
        for (Map.Entry<String, String> entry : params.entrySet()) {
            urlBuilder.append(entry.getKey()).append("=")
                      .append(URLEncoder.encode(entry.getValue(), "UTF-8")).append("&");
        }
        String url = urlBuilder.substring(0, urlBuilder.length() - 1);

        OkHttpClient client = new OkHttpClient();
        Request request = new Request.Builder().url(url).build();
        try (Response response = client.newCall(request).execute()) {
            String result = response.body().string();
            JSONObject json = JSONObject.parseObject(result);
            if (json.getBoolean("success")) {
                System.out.println("搜索结果：");
                for (Object itemObj : json.getJSONObject("result").getJSONArray("items")) {
                    JSONObject item = (JSONObject) itemObj;
                    System.out.println("商品ID: " + item.getString("item_id"));
                    System.out.println("商品名称: " + item.getString("title"));
                    System.out.println("价格: " + item.getString("price"));
                    System.out.println("销量: " + item.getString("sales"));
                }
            } else {
                System.out.println("错误：" + json.getString("errorMessage"));
            }
        }
    }

    private static String generateSign(Map<String, String> params, String appSecret) throws Exception {
        StringBuilder signStr = new StringBuilder();
        for (Map.Entry<String, String> entry : params.entrySet()) {
            signStr.append(entry.getKey()).append(entry.getValue());
        }
        signStr.append(appSecret);
        return URLEncoder.encode(new String(org.apache.commons.codec.digest.DigestUtils.md5Hex(signStr.toString()).getBytes("UTF-8")), "UTF-8").toUpperCase();
    }
}

四、注意事项

（一）遵守 API 使用规则

1. 遵守微店开放平台的 API 使用规则，不要频繁发起请求或超出请求限制。

2. 保护好 AppKey 和 AppSecret，不要泄露给任何人。

3. 及时关注微店开放平台的更新与变动，以便及时调整代码以适应新的 API 接口。

（二）优化代码性能

1. 数据缓存：对于短期内重复请求的数据，利用内存缓存（如 Java 的 Guava Cache）或分布式缓存（如 Redis）存储，下次请求时优先从缓存读取，减少 API 调用开销。

2. 优化请求频率：除遵循平台规则外，可采用延迟加载策略，在数据非紧急需求时，适当延长请求间隔，结合异步编程（如 Java 的 CompletableFuture），让请求在后台执行，不阻塞主线程，提升整体响应性能。

五、总结

通过上述步骤和代码示例，你可以高效地利用微店的 item_search 接口获取商品的详细信息。在实际应用中，需注意遵守微店开放平台的 API 使用规则，保护好 AppKey 和 AppSecret，并根据需求优化代码性能，以实现高效、稳定的数据获取。