1688商品详情接口（item_get）完整指南：从接入到实战

import hashlibdef generate_sign(params: dict, app_secret: str) -> str:
    """
    生成1688 API MD5签名
    """
    # 1. 过滤空值参数
    filtered_params = {k: v for k, v in params.items() if v is not None}
    
    # 2. 按参数名ASCII码升序排序
    sorted_params = sorted(filtered_params.items(), key=lambda x: x[0])
    
    # 3. 拼接字符串：AppSecret + key1value1key2value2... + AppSecret
    sign_str = app_secret + "".join([f"{k}{v}" for k, v in sorted_params]) + app_secret    
    # 4. MD5加密并转大写
    return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

import requestsimport timeimport hashlib# ==================== 配置区（替换为你的凭证） ====================APP_KEY = "your_app_key"APP_SECRET = "your_app_secret"API_URL = "https://gw.api.1688.com/openapi/param2/1/alibaba.item.get/2.0"def generate_sign(params: dict, app_secret: str) -> str:
    """生成MD5签名"""
    filtered = {k: v for k, v in params.items() if v is not None}
    sorted_params = sorted(filtered.items(), key=lambda x: x[0])
    sign_str = app_secret + "".join([f"{k}{v}" for k, v in sorted_params]) + app_secret    return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()def get_item_detail(item_id: str, fields: str = None) -> dict:
    """
    调用1688商品详情接口
    """
    # 构造基础参数
    params = {
        "app_key": APP_KEY,
        "method": "alibaba.item.get",
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "item_id": item_id    }
    
    # 按需指定返回字段
    if fields:
        params["fields"] = fields    
    # 生成签名
    params["sign"] = generate_sign(params, APP_SECRET)
    
    try:
        response = requests.get(API_URL, params=params, timeout=15)
        response.encoding = "utf-8"
        result = response.json()
        
        # 错误处理
        if result.get("code") != 0 or "error_response" in result:
            error = result.get("error_response", {})
            raise Exception(f"API调用失败: {error.get('msg', '未知错误')} (码: {error.get('code')})")
        
        return result["data"]["item_get_response"]["item"]
        
    except requests.exceptions.Timeout:
        raise Exception("请求超时，请检查网络或稍后重试")
    except Exception as e:
        raise Exception(f"请求异常: {str(e)}")# ==================== 调用示例 ====================if __name__ == "__main__":
    # 1688商品ID（从商品链接中获取）
    test_item_id = "689712345678"
    
    # 指定需要的字段（优化性能）
    target_fields = (
        "item_id,title,price,min_order_quantity,max_order_quantity,"
        "pic_url,item_imgs,sku_list,supplier_info,logistics_info,"
        "sales_info,status,props"
    )
    
    try:
        item = get_item_detail(test_item_id, target_fields)
        
        print("=" * 50)
        print(f"【商品标题】{item.get('title')}")
        print(f"【批发价】¥{item.get('price')}")
        print(f"【起订量】{item.get('min_order_quantity')} 件")
        print(f"【最大订购量】{item.get('max_order_quantity')} 件")
        print(f"【商品状态】{'在售' if item.get('status') == 'on_sale' else '下架'}")
        
        # 解析供应商信息
        supplier = item.get('supplier_info', {})
        print(f"\n【供应商】{supplier.get('supplier_name')}")
        print(f"【所在地】{supplier.get('province')} {supplier.get('city')}")
        print(f"【店铺类型】{supplier.get('supplier_type')}")
        
        # 解析SKU信息
        sku_list = item.get('sku_list', [])
        if sku_list:
            print(f"\n【SKU规格】共 {len(sku_list)} 个规格")
            for sku in sku_list[:3]:  # 仅展示前3个
                print(f"  - {sku.get('sku_spec')}: ¥{sku.get('sku_price')} (库存: {sku.get('sku_stock')})")
        
        # 解析物流信息
        logistics = item.get('logistics_info', {})
        print(f"\n【物流】{logistics.get('delivery_time', 'N/A')}")
        print(f"【运费】¥{logistics.get('freight', '0.00')}")
        
    except Exception as e:
        print(f"获取失败: {e}")

import com.alibaba.fastjson.JSON;import com.alibaba.fastjson.JSONObject;import org.apache.http.client.methods.CloseableHttpResponse;import org.apache.http.client.methods.HttpPost;import org.apache.http.entity.StringEntity;import org.apache.http.impl.client.CloseableHttpClient;import org.apache.http.impl.client.HttpClients;import org.apache.http.util.EntityUtils;import java.io.IOException;import java.net.URLEncoder;import java.text.SimpleDateFormat;import java.util.*;public class Item1688ApiClient {
    
    private final String appKey;
    private final String appSecret;
    private static final String API_URL = 
        "https://gw.open.1688.com/openapi/param2/2/portals.open/api.item.get/%s";
    
    public Item1688ApiClient(String appKey, String appSecret) {
        this.appKey = appKey;
        this.appSecret = appSecret;
    }
    
    public JSONObject getItemDetail(String offerId, String fields) throws Exception {
        Map<String, String> params = new HashMap<>();
        params.put("app_key", appKey);
        params.put("method", "portals.open.api.item.get");
        params.put("format", "json");
        params.put("v", "1.0");
        params.put("timestamp", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()));
        params.put("offerId", offerId);
        
        if (fields != null && !fields.isEmpty()) {
            params.put("fields", fields);
        }
        
        // 生成签名
        String sign = generateSign(params, appSecret);
        params.put("sign", sign);
        
        // 发送请求
        String response = sendPostRequest(String.format(API_URL, appKey), params);
        JSONObject result = JSON.parseObject(response);
        
        if (result.containsKey("error_response")) {
            JSONObject error = result.getJSONObject("error_response");
            throw new RuntimeException("API调用失败: " + error.getString("msg"));
        }
        
        return result.getJSONObject("item_get_response");
    }
    
    private String generateSign(Map<String, String> params, String secret) {
        List<String> keys = new ArrayList<>(params.keySet());
        Collections.sort(keys);
        
        StringBuilder sb = new StringBuilder(secret);
        for (String key : keys) {
            String value = params.get(key);
            if (value != null && !value.isEmpty()) {
                sb.append(key).append(value);
            }
        }
        sb.append(secret);
        
        return org.apache.commons.codec.digest.DigestUtils.md5Hex(sb.toString()).toUpperCase();
    }
    
    private String sendPostRequest(String url, Map<String, String> params) throws IOException {
        CloseableHttpClient client = HttpClients.createDefault();
        HttpPost post = new HttpPost(url);
        
        StringBuilder formData = new StringBuilder();
        for (Map.Entry<String, String> entry : params.entrySet()) {
            if (formData.length() > 0) formData.append("&");
            formData.append(entry.getKey()).append("=")
                   .append(URLEncoder.encode(entry.getValue(), "UTF-8"));
        }
        
        post.setEntity(new StringEntity(
            formData.toString(), 
            "application/x-www-form-urlencoded", 
            "UTF-8"
        ));
        
        try (CloseableHttpResponse response = client.execute(post)) {
            return EntityUtils.toString(response.getEntity(), "UTF-8");
        }
    }}

{
  "sku_list": [
    {
      "sku_id": "987654321012",
      "sku_spec": "白色-L",
      "sku_price": "19.90",
      "sku_stock": 5000,
      "available_stock": 4980,
      "sku_properties": [
        {"prop_name": "颜色", "value": "白色"},
        {"prop_name": "尺码", "value": "L"}
      ]
    }
  ]}

# 推荐：搜索+详情组合调用流程def batch_sync_items(keyword: str):
    # 第一步：搜索获取商品ID列表
    search_result = item_search(q=keyword, page=1)
    item_ids = [item['num_iid'] for item in search_result['items']]
    
    # 第二步：批量获取详情（带限流）
    for item_id in item_ids:
        detail = get_item_detail(item_id, fields="item_id,title,price,sku_list")
        save_to_database(detail)
        time.sleep(1.2)  # 控制QPS < 1