获取单个商品

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/jd/ware/findwarebyid

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String 38173182 京东的账号,对应蜂巢授权返回jdseller字段
sign String

业务参数

名称 类型 必须 示例值 描述
- wareId Number 1 商品id
- field String 例如 itemNum,barCode 可选的返回的字段

2. 请求示例代码(Java)

请求示例代码

 @Test
    public void  findWareById() throws Exception {

        String sellerNick = Config.JDSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("seller_nick", sellerNick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("wareId", "10022660724067");
        String fields = "wareId,title,categoryId,brandId,templateId,transportId,wareStatus,outerId,itemNum,barCode,wareLocation,modified,created,offlineTime,onlineTime,colType,delivery,adWords,wrap,packListing,weight,width,height,length,props,features,images,shopCategorys,mobileDesc,introduction,zhuangBaIntroduction,zhuangBaId,introductionUseFlag,afterSales,logo,marketPrice,costPrice,jdPrice,brandName,stockNum,categorySecId,shopId,promiseId,multiCategoryId,multiCateProps,sellPoint,wareTax,afterSaleDesc,zhuangBaMobileDesc,mobileZhuangBaId,mobileDescUseFlag,fitCaseHtmlPc,fitCaseHtmlApp,specialServices,parentId,wareGroupId,businessType,designConcept,isArchival,templateIds,spuId"; 
        data.put("field",fields );
        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDfindWareById, data);
    }

3. 返回结果如下:

返回结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "adWords": {
      "url": "",
      "urlWords": "",
      "words": "测试品牌(0506-2)宝贝发布0802(多组属性)"
    },
    "afterSales": "1年",
    "barCode": "",
    "brandId": 955844,
    "brandName": "测试品牌(0506-2)",
    "categoryId": 1355,
    "categorySecId": 0,
    "colType": 0,
    "costPrice": 0,
    "created": 1722566191000,
    "delivery": 579,
    "features": [
      {
        "featureKey": "scsj",
        "featureValue": "1722566184697"
      },
      {
        "featureKey": "zyyfmb",
        "featureValue": "1"
      },
      {
        "featureKey": "isTest",
        "featureValue": "1"
      },
      {
        "featureKey": "noShow",
        "featureValue": "1"
      },
      {
        "featureKey": "salemodel",
        "featureValue": "POP_MODEL"
      },
      {
        "featureKey": "deliveryTimeType",
        "featureValue": "1"
      },
      {
        "featureKey": "fply",
        "featureValue": "jospop-D03BE7C08B87C14BECBFF613ABBDB58E"
      },
      {
        "featureKey": "SoldOversea",
        "featureValue": "7"
      },
      {
        "featureKey": "is7ToReturn",
        "featureValue": "1"
      },
      {
        "featureKey": "wlzyc",
        "featureValue": "1"
      }
    ],
    "height": 77,
    "images": [
      {
        "colorId": "0000000000",
        "imgId": 350940216515,
        "imgIndex": 1,
        "imgUrl": "jfs/t1/298416/5/3366/55514/681888e8F6c0619c3/5c63b1c6e2393d3b.jpg"
      },
      {
        "colorId": "0000000000",
        "imgId": 350940216516,
        "imgIndex": 2,
        "imgUrl": "jfs/t1/56084/24/25496/211935/66ac41cfF1cb60abc/f5a7b949c46348dc.jpg"
      }
    ],
    "introduction": "<div><b><font color=\"#0000cc\">12</font></b></div><div><b><font color=\"#0000cc\">15645646<img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/108457/10/39502/211935/66aca2f2F3e88f251/2cfcde50b3a6be23.jpg\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/57675/23/24553/13762/66aca2f3F11997948/be1b871512ec8567.png\"><br></font></b></div><div><b><font color=\"#990033\">456546<br></font></b></div><div><b><font color=\"#006666\"><i>中华人民共和国<img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/83290/22/27318/205218/66ac41caF0e810e7f/594d34928e9e196e.jpg\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/40019/28/23128/733662/66ac41cbF60dc24d6/1622f5e3bbdefe82.jpg\" class=\"\" width=\"200\" height=\"200\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/23809/28/20901/13082/66ac41ccF6a976a0f/6ed74d5e6c952b17.png\"><br><br><br></i></font></b></div>",
    "itemNum": "sjbm0802",
    "jdPrice": 150,
    "length": 12,
    "logo": "jfs/t1/298416/5/3366/55514/681888e8F6c0619c3/5c63b1c6e2393d3b.jpg",
    "marketPrice": 181,
    "mobileDesc": "<div><b><font color=\"#0000cc\">12</font></b></div><div><b><font color=\"#0000cc\">15645646<img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/108457/10/39502/211935/66aca2f2F3e88f251/2cfcde50b3a6be23.jpg\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/57675/23/24553/13762/66aca2f3F11997948/be1b871512ec8567.png\"><br></font></b></div><div><b><font color=\"#990033\">456546<br></font></b></div><div><b><font color=\"#006666\"><i>中华人民共和国<img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/83290/22/27318/205218/66ac41caF0e810e7f/594d34928e9e196e.jpg\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/40019/28/23128/733662/66ac41cbF60dc24d6/1622f5e3bbdefe82.jpg\" class=\"\" width=\"200\" height=\"200\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/23809/28/20901/13082/66ac41ccF6a976a0f/6ed74d5e6c952b17.png\"><br><br><br></i></font></b></div>",
    "modified": 1749156585000,
    "multiCateProps": [
      {
        "attrId": "118771",
        "attrValueAlias": [
          "18-24周岁",
          "25-29周岁",
          "30-34周岁",
          "35-39周岁",
          "40-49周岁",
          "17周岁以下"
        ],
        "attrValues": [
          "638004",
          "638005",
          "638006",
          "638007",
          "638008",
          "638009"
        ],
        "expands": [
          "",
          "",
          "",
          "",
          "",
          ""
        ],
        "units": [
          "",
          "",
          "",
          "",
          "",
          ""
        ]
      },
      {
        "attrId": "19946",
        "attrValueAlias": [
          "修身型"
        ],
        "attrValues": [
          "294360"
        ],
        "expands": [
          ""
        ],
        "units": [
          ""
        ]
      },
      {
        "attrId": "118770",
        "attrValueAlias": [
          "甜美风"
        ],
        "attrValues": [
          "1070263"
        ],
        "expands": [
          ""
        ],
        "units": [
          ""
        ]
      },
      {
        "attrId": "9772",
        "attrValueAlias": [
          "棉",
          "竹纤维",
          "粘纤(粘胶纤维)",
          "醋纤(醋酯纤维)",
          "莫代尔",
          "涤纶(聚酯纤维)",
          "桑蚕丝",
          "铜氨纤维",
          "氨纶(聚氨酯弹性纤维)",
          "丙纶(聚丙烯纤维)",
          "锦纶/尼龙(聚酰胺纤维)",
          "金属纤维",
          "聚酯复合弹性纤维",
          "黄麻(黄麻及同类纤维)",
          "牛毛纤维",
          "聚酯薄膜纤维",
          "牦牛毛",
          "碳纤维",
          "PU(聚氨酯)",
          "其他",
          "大豆蛋白纤维(大豆纤维)",
          "大麻(汉麻/火麻)",
          "弹性纤维",
          "金属镀膜纤维",
          "腈纶(聚丙烯腈纤维)",
          "莱赛尔",
          "木棉",
          "三醋酯纤维",
          "山羊绒",
          "头层牛皮",
          "兔毛",
          "亚麻",
          "羊毛",
          "再生纤维素纤维",
          "柞蚕丝",
          "苎麻",
          "羊皮革"
        ],
        "attrValues": [
          "709842",
          "664114",
          "709845",
          "709846",
          "165653",
          "709847",
          "709856",
          "1445017",
          "709860",
          "709861",
          "709862",
          "1445328",
          "1445446",
          "1445759",
          "1445824",
          "1445859",
          "1429408",
          "1445918",
          "742653",
          "987048",
          "742658",
          "742659",
          "742661",
          "742666",
          "742668",
          "742673",
          "742683",
          "742686",
          "742688",
          "742692",
          "742693",
          "742695",
          "742696",
          "742699",
          "742700",
          "742702",
          "1592001"
        ],
        "expands": [
          "1",
          "1",
          "1",
          "1",
          "1" 
        ],
        "units": [
          "%"
        ]
      },
      {
        "attrId": "174076",
        "attrValueAlias": [
          "棉布",
          "棉混纺",
          "牛奶丝",
          "罗纹布",
          "混纺",
          "摇粒绒",
          "雪纺",
          "铜氨丝",
          "天鹅绒",
          "丝绸",
          "乔其纱",
          "欧根纱",
          "牛仔布",
          "牛津纺",
          "尼丝纺",
          "金丝绒",
          "涤塔夫",
          "灯芯绒",
          "LYCRA莱卡"
        ],
        "attrValues": [
          "1459496",
          "1489138",
          "1588990",
          "1588991",
          "1459497",
          "882562",
          "882572",
          "882589",
          "882600",
          "882607",
          "882615",
          "882622",
          "882630",
          "882636",
          "882641",
          "882645",
          "882653",
          "882656",
          "882659"
        ],
        "expands": [
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          ""
        ],
        "units": [
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          "",
          ""
        ]
      },
      {
        "attrId": "19957",
        "attrValueAlias": [
          "荡领"
        ],
        "attrValues": [
          "1519636"
        ],
        "expands": [
          ""
        ],
        "units": [
          ""
        ]
      },
      {
        "attrId": "19952",
        "attrValueAlias": [
          "短款"
        ],
        "attrValues": [
          "1006142"
        ],
        "expands": [
          ""
        ],
        "units": [
          ""
        ]
      },
      {
        "attrId": "83110",
        "attrValueAlias": [
          "2024年秋季"
        ],
        "attrValues": [
          "1365069"
        ],
        "expands": [
          ""
        ],
        "units": [
          ""
        ]
      },
      {
        "attrId": "83118",
        "attrValueAlias": [
          "露肩",
          "3D"
        ],
        "attrValues": [
          "498297",
          "638044"
        ],
        "expands": [
          "",
          ""
        ],
        "units": [
          "",
          ""
        ]
      },
      {
        "attrId": "118775",
        "attrValueAlias": [
          "圆点",
          "爱心",
          "蝴蝶结",
          "纯色",
          "格子",
          "渐变",
          "豹纹",
          "斑马纹",
          "条纹",
          "脸谱",
          "人物",
          "风景",
          "碎花",
          "骷髅",
          "大花",
          "建筑",
          "游戏",
          "动物",
          "迷彩",
          "文字",
          "数字",
          "字母",
          "千鸟格",
          "宇宙星空",
          "植物花卉",
          "卡通动漫",
          "手绘",
          "几何图案",
          "科技科幻",
          "LOGO",
          "抽象图案",
          "中国文化",
          "搞怪",
          "运动",
          "创意趣味"
        ],
        "attrValues": [
          "710049",
          "1501231",
          "1506555",
          "638083",
          "709921",
          "742705",
          "709922",
          "709923",
          "742708",
          "709926",
          "638092",
          "709927",
          "638093",
          "709928",
          "638094",
          "709929",
          "638100",
          "709920",
          "638101",
          "638102",
          "638104",
          "638105",
          "638108",
          "638110",
          "638111",
          "638114",
          "638116",
          "638120",
          "638122",
          "638124",
          "638127",
          "638130",
          "638134",
          "638136",
          "638138"
        ],
        "expands": [

        ],
        "units": [
          "",

        ]
      },
      {
        "attrId": "9780",
        "attrValueAlias": [
          "公主袖"
        ],
        "attrValues": [
          "165874"
        ],
        "expands": [
          ""
        ],
        "units": [
          ""
        ]
      }
    ],
    "multiCategoryId": 1355,
    "offlineTime": 1733311601000,
    "onlineTime": 1733890832000,
    "outerId": "454",
    "packListing": "纽扣x3",
    "promiseId": 30528550,
    "shopCategorys": [],
    "shopId": 617857,
    "spuId": 0,
    "stockNum": 0,
    "templateId": 0,
    "title": "测试品牌1夏季女士T恤衫0802-1",
    "transportId": 2593375,
    "wareId": 10026288980564,
    "wareLocation": 2,
    "wareStatus": 8,
    "weight": 0.5,
    "width": 55,
    "wrap": "0"
  }
}

京东图片前缀地址为:https://img12.360buyimg.com/n5

说明: code为0表示成功,非0为失败,message会包含失败原因。返回字段说明 https://open.jd.com/v2/#/doc/api?apiCateId=48&apiId=1223&apiName=jingdong.sku.read.findSkuById&gwType=0

文档更新时间: 2025-06-13 13:39   作者:admin