获取商品信息

根据商品id获取商家的商品详情，不返回已删除的商品

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/ks/item/get

公共参数

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

业务参数

参数名称	参数类型	是否必须	示例值	参数描述
kwaiItemId	String	是		商品ID

二、请求示例代码

Java

请求示例代码

@Test
public void itemGet() throws Exception {

    String sellerNick = Config.KSSellerNick ;
    //业务参数
    Map<String, String> data = new HashMap();
    data.put("appid",  Config.AppId);
    data.put("seller_nick", sellerNick);
    Long timestamp = System.currentTimeMillis();
    data.put("timestamp", timestamp.toString());
    data.put("kwaiItemId", "3655213008601");
    // 参数签名
    data.put("sign", Utils.Sign(data, Config.AppSecret));
    String result = doHttpRequest(Config.KS_OPEN_ITEM_GET, data);
    System.out.println("result:"+result);
}

三、返回结果

{
    "code": 0,
    "message": "ok",
    "data": {
        "auditReason": "",
        "auditStatus": 2,
        "categoryId": 2995,
        "categoryName": "其他日用",
        "contractPhone": false,
        "createdTime": 1634016961796,
        "detailImageUrls": [],
        "details": "回形针特别版",
        "duplicationReason": "",
        "duplicationStatus": 2,
        "expressTemplateId": 9426102401,
        "imageUrls": [
            "https://u1-203.ecukwai.com/ufile/adsocial/6195808d-8969-46a5-a7e9-bb506c95e856.jpg"
        ],
        "instructions": "",
        "itemId": 3655213008601,
        "itemPropValues": [
            {
                "checkBoxPropValuesList": [],
                "dateRange": {
                    "endTimeTimestamp": 0,
                    "startTimeTimestamp": 0
                },
                "datetimeTimestamp": 0,
                "imagePropValues": [],
                "inputType": 8,
                "propAlias": "品牌",
                "propId": 102,
                "propName": "品牌",
                "propType": 2,
                "radioPropValue": {
                    "propValue": "铁帮手",
                    "propValueId": 411029
                },
                "sortNum": 2147483647,
                "textPropValue": "",
                "unitPropValueId": 0,
                "unitPropValueName": ""
            }
        ],
        "itemQualification": [],
        "itemRemark": "",
        "limitCount": 99,
        "linkUrl": "https://app.kwaixiaodian.com/merchant/shop/detail?id=3655213008601\u0026hyId=kwaishop\u0026layoutType=4",
        "multipleStock": false,
        "offlineReason": "",
        "onOfflineStatus": 1,
        "parentCategoryId": 2988,
        "parentCategoryList": [
            {
                "categoryId": 1107,
                "categoryName": "家居生活",
                "categoryPid": 0
            },
            {
                "categoryId": 1124,
                "categoryName": "居家日用",
                "categoryPid": 1107
            },
            {
                "categoryId": 2988,
                "categoryName": "生活日用",
                "categoryPid": 1124
            }
        ],
        "parentCategoryName": "生活日用",
        "poiIds": [],
        "purchaseLimit": true,
        "relItemId": 3655213008601,
        "rootCategoryId": 1107,
        "rootCategoryName": "家居生活",
        "sellingPoint": "",
        "serviceRule": {
            "certEndTime": 0,
            "certExpDays": 0,
            "certExpireType": 0,
            "certMerchantCode": "",
            "certStartTime": 0,
            "customerInfo": {
                "customerCertificateType": [],
                "customerInfoType": ""
            },
            "deliveryMethod": "logistics",
            "deliveryTimeMode": "spot",
            "maxOrderCount": 0,
            "minOrderCount": 0,
            "orderPurchaseLimitType": 0,
            "priceProtectDays": 0,
            "promiseDeliveryTime": 172800,
            "refundRule": "支持7天无理由退货",
            "servicePromise": {
                "allergyRefund": false,
                "brokenRefund": true,
                "freshRotRefund": false
            },
            "theDayOfDeliverGoodsTime": 0,
            "unavailableTimeRule": {
                "holidays": [],
                "timeRanges": [],
                "weeks": []
            }
        },
        "shortTitle": "",
        "skuInfos": [
            {
                "appkey": "",
                "createTime": 1634016962016,
                "gtinCode": "",
                "imageUrl": "",
                "isValid": 1,
                "kwaiItemId": 3655213008601,
                "kwaiSkuId": 4810616921601,
                "mealDetail": {
                    "highestPeopleNum": 0,
                    "lowestPeopleNum": 0,
                    "mealGroup": [],
                    "mealGroupDTOList": []
                },
                "packageCode": "",
                "relSkuId": 0,
                "reserveStock": 0,
                "skuNick": "837",
                "skuProp": [
                    {
                        "createTime": 1634018612920,
                        "imageUrl": "https://u1-203.ecukwai.com/ufile/adsocial/6195808d-8969-46a5-a7e9-bb506c95e856.jpg",
                        "isMainProp": 0,
                        "isValid": 1,
                        "itemId": 3655213008601,
                        "propId": 440378662,
                        "propName": "颜色",
                        "propSortNum": 1,
                        "propValueGroupId": 0,
                        "propValueId": 440378663,
                        "propValueName": "黑色",
                        "propValueRemarks": "",
                        "propValueSortNum": 1,
                        "propVersion": 1,
                        "skuId": 4810616921601,
                        "skuPropId": 57752913,
                        "updateTime": 1675479787708
                    }
                ],
                "skuSalePrice": 10,
                "skuStock": 2218,
                "specification": "黑色",
                "updateTime": 1675479787696,
                "volume": 1
            },
            {
                "appkey": "",
                "createTime": 1634016962016,
                "gtinCode": "",
                "imageUrl": "",
                "isValid": 1,
                "kwaiItemId": 3655213008601,
                "kwaiSkuId": 4810616922601,
                "mealDetail": {
                    "highestPeopleNum": 0,
                    "lowestPeopleNum": 0,
                    "mealGroup": [],
                    "mealGroupDTOList": []
                },
                "packageCode": "",
                "relSkuId": 0,
                "reserveStock": 0,
                "skuNick": "",
                "skuProp": [
                    {
                        "createTime": 1634018612920,
                        "imageUrl": "https://u1-203.ecukwai.com/ufile/adsocial/6195808d-8969-46a5-a7e9-bb506c95e856.jpg",
                        "isMainProp": 0,
                        "isValid": 1,
                        "itemId": 3655213008601,
                        "propId": 440378662,
                        "propName": "颜色",
                        "propSortNum": 1,
                        "propValueGroupId": 0,
                        "propValueId": 440378664,
                        "propValueName": "白色",
                        "propValueRemarks": "",
                        "propValueSortNum": 2,
                        "propVersion": 1,
                        "skuId": 4810616922601,
                        "skuPropId": 57752914,
                        "updateTime": 1675479787708
                    }
                ],
                "skuSalePrice": 10,
                "skuStock": 2221,
                "specification": "白色",
                "updateTime": 1675479787704,
                "volume": 0
            }
        ],
        "timeOfSale": 0,
        "title": "专用的回形针",
        "transparentImageUrl": "",
        "updateTime": 1687410364739,
        "whiteBaseImageUrl": ""
    }
}

四、返回字段说明

返回字段说明见官方文档： https://open.kwaixiaodian.com/docs/api?categoryId=44&apiName=open.item.get&version=1