Node.js 实战：快速接入京东 API 并抓取商品详情数据

npm init -y
npm install axios crypto-js dotenv

jd-api-demo/
├─ .env                # 存储敏感信息（appKey、appSecret）
├─ index.js            # 核心代码
└─ package.json        # 依赖配置

JD_APP_KEY=你的appKey
JD_APP_SECRET=你的appSecret
JD_API_URL=https://api.jd.com/routerjson  # 京东API通用网关地址

// 导入依赖包
const axios = require('axios');
const CryptoJS = require('crypto-js');
require('dotenv').config(); // 加载.env配置

/**
 * 生成京东API请求签名
 * @param {Object} params - 请求参数（含公共参数和业务参数）
 * @param {string} appSecret - 应用密钥
 * @returns {string} 签名结果（大写）
 */
function generateSign(params, appSecret) {
  // 1. 按参数名ASCII升序排序
  const sortedParams = Object.keys(params).sort().reduce((obj, key) => {
    obj[key] = params[key];
    return obj;
  }, {});

  // 2. 拼接为"key=value&key=value"格式
  const paramStr = Object.entries(sortedParams)
    .map(([key, value]) => `${key}=${value}`)
    .join('&');

  // 3. HMAC-SHA256加密 + 转大写
  const sign = CryptoJS.HmacSHA256(paramStr, appSecret);
  return CryptoJS.enc.Hex.stringify(sign).toUpperCase();
}

/**
 * 调用京东API获取商品详情
 * @param {string} skuId - 商品SKU ID（京东商品唯一标识，可从商品URL中获取）
 * @returns {Promise<Object>} 商品详情数据
 */
async function getJdProductDetail(skuId) {
  try {
    // 1. 配置公共参数（所有API请求必传）
    const publicParams = {
      app_key: process.env.JD_APP_KEY,
      method: 'jd.union.open.goods.detail.query', // 商品详情查询接口（京东官方接口名）
      format: 'json', // 响应格式
      v: '1.0', // API版本
      timestamp: new Date().toISOString().replace(/T/, ' ').replace(/\.\d+Z$/, ''), // 时间戳（格式：YYYY-MM-DD HH:mm:ss）
      sign_method: 'hmac-sha256' // 签名算法
    };

    // 2. 配置业务参数（当前接口需传商品SKU ID）
    const businessParams = {
      skuIds: skuId // 支持多个SKU，用英文逗号分隔（如"123456,789012"）
    };

    // 3. 合并参数（公共参数 + 业务参数）
    const requestParams = {
      ...publicParams,
      param_json: JSON.stringify(businessParams) // 业务参数需转JSON字符串
    };

    // 4. 生成签名
    requestParams.sign = generateSign(requestParams, process.env.JD_APP_SECRET);

    // 5. 发送GET请求调用API
    const response = await axios.get(process.env.JD_API_URL, {
      params: requestParams
    });

    // 6. 解析响应数据（根据京东API返回格式处理）
    const result = response.data;
    if (result.code === 0 && result.data) {
      // 提取关键商品信息（可根据需求扩展）
      const product = result.data[0];
      return {
        skuId: product.skuId,
        name: product.skuName, // 商品名称
        price: product.price, // 商品价格
        imageUrl: product.imageUrl, // 商品主图
        shopName: product.shopName, // 店铺名称
        category: product.categoryName // 商品分类
      };
    } else {
      throw new Error(`API请求失败：${result.msg || '未知错误'}`);
    }
  } catch (error) {
    console.error('获取商品详情失败：', error.message);
    throw error; // 抛出错误，供调用方处理
  }
}

// 测试：获取指定SKU的商品详情（示例SKU：京东自营商品）
const testSkuId = '100012345678'; // 替换为实际需要查询的SKU ID
getJdProductDetail(testSkuId)
  .then(product => {
    console.log('商品详情获取成功：');
    console.log(JSON.stringify(product, null, 2));
  })
  .catch(err => {
    console.error('测试失败：', err.message);
  });

node index.js

{
  "skuId": "100012345678",
  "name": "【京东自营】XX品牌 55英寸4K智能电视",
  "price": 2999.00,
  "imageUrl": "https://img14.360buyimg.com/n1/jfs/t1/xxx/xxx/xxx/xxx.jpg",
  "shopName": "XX品牌京东自营旗舰店",
  "category": "家用电器>电视>4K电视"
}