import requests
import hashlib

# ************************ 替换为自己的核心凭证 ************************
API_URL = "https://xxx.xxx.xxx/api/taobao/item/detail"  # 第三方服务商的API请求地址
APP_KEY = "你的AppKey"  # 服务商提供的AppKey
APP_SECRET = "你的AppSecret"  # 服务商提供的AppSecret
ITEM_ID = "1234567890"  # 要获取的淘宝商品ID（字符串类型）
# *********************************************************************

def generate_md5_sign(app_key: str, item_id: str, app_secret: str) -> str:
    """
    生成MD5签名，遵循第三方API的通用规则
    :param app_key: 服务商提供的AppKey
    :param item_id: 淘宝商品ID
    :param app_secret: 服务商提供的AppSecret
    :return: 加密并转大写后的签名
    """
    # 严格按拼接顺序构造签名字符串，无冗余字符
    sign_str = f"{app_key}{item_id}{app_secret}"
    # MD5加密：UTF-8编码 → 加密 → 转16进制字符串 → 转大写
    md5_obj = hashlib.md5(sign_str.encode("utf-8"))
    sign = md5_obj.hexdigest().upper()
    return sign

def call_taobao_api() -> None:
    """
    调用第三方淘宝商品详情API主函数
    """
    # 1. 生成签名
    sign = generate_md5_sign(APP_KEY, ITEM_ID, APP_SECRET)
    # 2. 构造请求参数（必传参数仅3个，无额外冗余）
    request_params = {
        "app_key": APP_KEY,
        "item_id": ITEM_ID,
        "sign": sign
    }
    try:
        # 3. 发送GET请求，设置10s超时，避免网络波动导致挂起
        response = requests.get(
            url=API_URL,
            params=request_params,
            timeout=10
        )
        # 4. 验证HTTP请求结果
        if response.status_code == 200:
            # 解析为JSON格式，获取返回结果
            result = response.json()
            print("第三方API调用成功，原始返回数据：\n", result)
        else:
            print(f"HTTP请求失败，状态码：{response.status_code}，响应内容：{response.text}")
    except requests.exceptions.Timeout:
        print("API调用失败：请求超时（网络波动/服务商节点问题）")
    except requests.exceptions.ConnectionError:
        print("API调用失败：网络连接异常（检查接口地址/网络）")
    except Exception as e:
        print(f"API调用异常：{str(e)}")

if __name__ == "__main__":
    # 执行API调用
    call_taobao_api()

<!-- OkHttp网络请求依赖 -->
<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.12.0</version>
</dependency>
<!-- commons-codec加密依赖 -->
<dependency>
    <groupId>commons-codec</groupId>
    <artifactId>commons-codec</artifactId>
    <version>1.15</version>
</dependency>
<!-- 快速解析JSON -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.32</version>
</dependency>

import com.alibaba.fastjson2.JSONObject;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import org.apache.commons.codec.digest.DigestUtils;

import java.io.IOException;
import java.util.concurrent.TimeUnit;

public class TaobaoItemApiClient {
    // ************************ 替换为自己的核心凭证 ************************
    private static final String API_URL = "https://xxx.xxx.xxx/api/taobao/item/detail";
    private static final String APP_KEY = "你的AppKey";
    private static final String APP_SECRET = "你的AppSecret";
    private static final String ITEM_ID = "1234567890";
    // *********************************************************************

    /**
     * 生成MD5签名
     */
    private static String generateMd5Sign(String appKey, String itemId, String appSecret) {
        // 按规则拼接签名字符串
        String signStr = appKey + itemId + appSecret;
        // MD5加密+转大写
        return DigestUtils.md5Hex(signStr.getBytes()).toUpperCase();
    }

    /**
     * 调用第三方淘宝商品详情API
     */
    public static void callTaobaoItemApi() {
        // 1. 生成签名
        String sign = generateMd5Sign(APP_KEY, ITEM_ID, APP_SECRET);
        // 2. 构造请求URL（拼接参数）
        String requestUrl = String.format("%s?app_key=%s&item_id=%s&sign=%s",
                API_URL, APP_KEY, ITEM_ID, sign);
        // 3. 配置OkHttpClient，设置10s超时
        OkHttpClient client = new OkHttpClient.Builder()
                .connectTimeout(10, TimeUnit.SECONDS)
                .readTimeout(10, TimeUnit.SECONDS)
                .writeTimeout(10, TimeUnit.SECONDS)
                .build();
        // 4. 构造GET请求
        Request request = new Request.Builder().url(requestUrl).get().build();

        try (Response response = client.newCall(request).execute()) {
            // 5. 验证请求结果
            if (response.isSuccessful() && response.body() != null) {
                // 解析JSON结果
                String responseBody = response.body().string();
                JSONObject result = JSONObject.parseObject(responseBody);
                System.out.println("第三方API调用成功，原始返回数据：\n" + result);
            } else {
                System.out.println("HTTP请求失败，状态码：" + response.code());
            }
        } catch (IOException e) {
            if (e.getMessage().contains("timeout")) {
                System.out.println("API调用失败：请求超时");
            } else {
                System.out.println("API调用异常：" + e.getMessage());
            }
        }
    }

    // 主函数执行
    public static void main(String[] args) {
        callTaobaoItemApi();
    }
}

{
  "code": 200,        // 业务状态码（200/0为成功，非该值为失败）
  "msg": "success",   // 状态信息（失败时为具体错误原因）
  "data": {           // 商品核心数据层（成功时才有，嵌套所有商品信息）
    "item_id": "1234567890",
    "title": "淘宝商品标题",
    "price": "99.9",  // 实际售价
    "original_price": "199.9", // 原价
    "sales": 1000,    // 销量
    "stock": 5000,    // 库存
    "pic_url": "https://img-taobao.com/xxx.jpg", // 商品主图
    "category": "服饰鞋包-女装", // 商品类目
    "shop_info": {    // 嵌套字段：店铺信息
      "shop_id": "987654",
      "shop_name": "XX淘宝店铺"
    }
    // 其他字段：详情图、商品规格、运费等，按服务商返回为准
  }
}

# 解析业务结果
if result.get("code") == 200:
    # 提取数据层，做非空判断，避免data为null
    item_data = result.get("data", {})
    # 提取核心字段，全量非空判断+类型转换
    core_item_info = {
        "商品ID": item_data.get("item_id", ""),
        "商品标题": item_data.get("title", ""),
        "实际售价": float(item_data.get("price", 0.0)),
        "原价": float(item_data.get("original_price", 0.0)),
        "月销量": int(item_data.get("sales", 0)),
        "库存": int(item_data.get("stock", 0)),
        "商品主图": item_data.get("pic_url", ""),
        "商品类目": item_data.get("category", ""),
        # 嵌套字段提取：双重非空判断
        "店铺名称": item_data.get("shop_info", {}).get("shop_name", ""),
        "店铺ID": item_data.get("shop_info", {}).get("shop_id", "")
    }
    print("===== 解析后的商品核心数据 =====")
    for key, value in core_item_info.items():
        print(f"{key}：{value}")
else:
    # 业务调用失败，打印错误信息
    print(f"第三方API业务调用失败，错误码：{result.get('code')}，错误信息：{result.get('msg')}")

// 解析业务结果
String responseBody = response.body().string();
JSONObject result = JSONObject.parseObject(responseBody);
if (result.getIntValue("code") == 200) {
    // 提取数据层，做非空判断
    JSONObject itemData = result.getJSONObject("data");
    if (itemData == null) {
        itemData = new JSONObject();
    }
    // 提取核心字段，非空判断+类型转换
    String itemId = itemData.getString("item_id") == null ? "" : itemData.getString("item_id");
    String title = itemData.getString("title") == null ? "" : itemData.getString("title");
    double price = itemData.getDoubleValue("price");
    double originalPrice = itemData.getDoubleValue("original_price");
    int sales = itemData.getIntValue("sales");
    int stock = itemData.getIntValue("stock");
    String picUrl = itemData.getString("pic_url") == null ? "" : itemData.getString("pic_url");
    // 嵌套字段提取
    JSONObject shopInfo = itemData.getJSONObject("shop_info");
    String shopName = shopInfo == null ? "" : shopInfo.getString("shop_name");
    // 打印解析结果
    System.out.println("===== 解析后的商品核心数据 =====");
    System.out.println("商品ID：" + itemId);
    System.out.println("商品标题：" + title);
    System.out.println("实际售价：" + price);
    System.out.println("店铺名称：" + shopName);
} else {
    // 业务调用失败
    System.out.println("第三方API业务调用失败：" + result.getString("msg"));
}