Python/Java 代码示例：手把手教程调用 1688 API 获取商品详情实时数据

import requests
import hashlib
import time
from urllib.parse import urlencode

def get_1688_item_detail(app_key, app_secret, item_id):
    """
    调用1688 API获取商品详情
    :param app_key: 应用App Key
    :param app_secret: 应用App Secret
    :param item_id: 商品ID（1688商品详情页中的id）
    :return: 商品详情字典（若失败返回None）
    """
    # 1. 定义API基础参数
    params = {
        "app_key": app_key,
        "method": "alibaba.item.get",  # 固定接口名称
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),  # 当前时间戳
        "format": "json",  # 返回JSON格式
        "v": "2.0",  # 固定版本
        "item_id": item_id  # 目标商品ID
    }

    # 2. 生成签名（按1688 API规则）
    # 步骤1：按参数名ASCII升序排序
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    # 步骤2：拼接参数字符串（key=value&key=value）+ 拼接App Secret
    sign_str = ""
    for key, value in sorted_params:
        sign_str += f"{key}={value}&"
    # 移除最后一个&，并拼接App Secret
    sign_str = sign_str[:-1] + app_secret
    # 步骤3：MD5加密（32位小写）
    sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().lower()
    # 将签名加入参数列表
    params["sign"] = sign

    # 3. 构造请求URL（GET方式，参数拼接在URL后）
    api_url = "https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.item.get"
    request_url = api_url + "?" + urlencode(params)

    try:
        # 4. 发送HTTP请求（设置超时时间10秒，避免请求阻塞）
        response = requests.get(request_url, timeout=10)
        # 5. 解析返回结果（JSON格式）
        result = response.json()

        # 6. 验证请求是否成功（1688 API成功返回code=0）
        if result.get("error_response"):
            # 打印错误信息（如权限不足、商品ID不存在等）
            error_msg = result["error_response"]["msg"]
            print(f"API调用失败：{error_msg}")
            return None
        else:
            # 提取商品核心信息（可根据需求扩展字段）
            item_info = result["alibaba_item_get_response"]["result"]["item"]
            detail_data = {
                "商品ID": item_info["item_id"],
                "商品标题": item_info["title"],
                "原价（元）": item_info["original_price"],
                "批发价（元）": item_info["trade_price"],
                "库存数量": item_info["stock"],
                "商品链接": item_info["detail_url"],
                "卖家名称": item_info["seller"]["nick"],
                "发货地址": item_info["seller"]["address"]
            }
            return detail_data

    except Exception as e:
        # 捕获网络异常、超时等错误
        print(f"请求异常：{str(e)}")
        return None

# ------------------- 调用示例 -------------------
if __name__ == "__main__":
    # 替换为你的App Key、App Secret和目标商品ID
    APP_KEY = "your_app_key"  # 例如："12345678"
    APP_SECRET = "your_app_secret"  # 例如："abcdef1234567890abcdef1234567890"
    ITEM_ID = "123456789"  # 例如："6987654321"（替换为真实商品ID）

    # 调用函数获取商品详情
    item_detail = get_1688_item_detail(APP_KEY, APP_SECRET, ITEM_ID)

    # 打印结果
    if item_detail:
        print("商品详情实时数据：")
        for key, value in item_detail.items():
            print(f"{key}：{value}")
    else:
        print("未获取到商品详情")

<dependencies>
    <!-- OkHttp：HTTP请求库 -->
    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>4.9.3</version>
    </dependency>
    <!-- commons-codec：MD5加密工具 -->
    <dependency>
        <groupId>commons-codec</groupId>
        <artifactId>commons-codec</artifactId>
        <version>1.15</version>
    </dependency>
</dependencies>

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import org.apache.commons.codec.digest.DigestUtils;

import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.*;

public class Ali1688ApiDemo {
    // 1. 配置API核心参数（替换为你的真实参数）
    private static final String APP_KEY = "your_app_key"; // 你的App Key
    private static final String APP_SECRET = "your_app_secret"; // 你的App Secret
    private static final String API_URL = "https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.item.get"; // API请求地址

    /**
     * 生成1688 API签名
     * @param params 请求参数（不含sign）
     * @return 签名字符串（32位小写MD5）
     */
    private static String generateSign(Map<String, String> params) {
        // 步骤1：按参数名ASCII升序排序
        List<Map.Entry<String, String>> entryList = new ArrayList<>(params.entrySet());
        Collections.sort(entryList, Comparator.comparing(Map.Entry::getKey));

        // 步骤2：拼接参数字符串（key=value&key=value）+ 拼接App Secret
        StringBuilder signSb = new StringBuilder();
        for (Map.Entry<String, String> entry : entryList) {
            signSb.append(entry.getKey()).append("=").append(entry.getValue()).append("&");
        }
        // 移除最后一个&，并拼接App Secret
        String signStr = signSb.substring(0, signSb.length() - 1) + APP_SECRET;

        // 步骤3：MD5加密（32位小写）
        return DigestUtils.md5Hex(signStr).toLowerCase();
    }

    /**
     * 调用1688 API获取商品详情
     * @param itemId 商品ID
     * @return 商品详情JSON字符串（若失败返回null）
     */
    public static String get1688ItemDetail(String itemId) {
        // 2. 构建请求参数
        Map<String, String> params = new HashMap<>();
        params.put("app_key", APP_KEY);
        params.put("method", "alibaba.item.get"); // 固定接口名称
        params.put("timestamp", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date())); // 当前时间戳
        params.put("format", "json"); // 返回JSON格式
        params.put("v", "2.0"); // 固定版本
        params.put("item_id", itemId); // 目标商品ID

        // 3. 生成签名并加入参数
        String sign = generateSign(params);
        params.put("sign", sign);

        // 4. 拼接请求URL（GET方式，参数拼接在URL后）
        StringBuilder urlSb = new StringBuilder(API_URL).append("?");
        for (Map.Entry<String, String> entry : params.entrySet()) {
            urlSb.append(entry.getKey()).append("=").append(entry.getValue()).append("&");
        }
        String requestUrl = urlSb.substring(0, urlSb.length() - 1); // 移除最后一个&

        // 5. 使用OkHttp发送GET请求
        OkHttpClient client = new OkHttpClient();
        Request request = new Request.Builder().url(requestUrl).build();

        try (Response response = client.newCall(request).execute()) {
            // 6. 验证响应是否成功
            if (response.isSuccessful() && response.body() != null) {
                return response.body().string();
            } else {
                System.out.println("API请求失败，响应码：" + response.code());
                return null;
            }
        } catch (IOException e) {
            System.out.println("请求异常：" + e.getMessage());
            return null;
        }
    }

    // ------------------- 调用示例 -------------------
    public static void main(String[] args) {
        String itemId = "123456789"; // 替换为真实商品ID（例如："6987654321"）
        String itemDetailJson = get1688ItemDetail(itemId);

        if (itemDetailJson != null) {
            System.out.println("商品详情实时数据（JSON）：");
            System.out.println(itemDetailJson);
            // 若需解析JSON为Java对象，可使用FastJSON、Jackson等库（需额外添加依赖）
            // 示例（FastJSON）：JSONObject jsonObj = JSON.parseObject(itemDetailJson);
            // String title = jsonObj.getJSONObject("alibaba_item_get_response").getJSONObject("result").getJSONObject("item").getString("title");
            // System.out.println("商品标题：" + title);
        } else {
            System.out.println("未获取到商品详情");
        }
    }
}