发布商品前置检测接口

1.商品检测接口,会对传到接口内的商品标题,图片等进行合规性检查

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/jd/pop/ware/predetect

公共参数

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

业务参数

名称 类型 必须 示例值 描述
i18nParam com.jd.pop.seller.i18n.common.params.I18nParam 国际化参数
- country String zh 国家
request com.jd.pop.keeper.sdk.domain.WarePreDetectRequest 请求参数
- thirdCid Number 1 三级类目Id
- payFirst Number 1 是否先付款(0:支持货到付款,1:不支持)
- giftGoods Number 1 是否赠品(0:非赠品,1:赠品不可单独销售,2:赠品可单独销售)
- brandId Number 1 品牌Id
- adWords String 测试广告语 广告语
- slogan String 标语 标语,没有传空字符串
appDescImages java.util.Set app商详图片集合,最多8张
- - - String jfs/t1/…
shopId Number 1 店铺Id
transparentImages java.util.Set 透图jsf url集合,最多8张
- - - String jfs/t1/…
pcDescImages java.util.Set pc商详图片集合,最多8张
- - - String 1
pcDescText String 我是pc商详文本 pc商详文本
firstCid Number 1 一级类目Id
secondCid Number 1 二级类目Id
wareId Number 1 商品id
hrefSlogan String 我是标语 标语 + 链接文字
productArea String 1 产地
appDescText String 我是app商详文本 app商详文本
source Number 1 来源,1代表POP商品,3代表自营商品
wareName String 我是商品标题 商品名称
unLimitCid Number 1 末级类目Id
shopName String 测试店铺 店铺名称
factoryShip Number 1 是否厂家直送(0:不支持:1:支持)
skus java.util.List<WarePreDetectRequest$Sku> sku集合,最多299个
- skuId String 1 skuId
- color String red color
- size String xl size
- images java.util.Set sku图片jsf url集合,最多8张
- - - String jfs/t1/…
- skuAttrs java.util.List sku属性集合,最多不限
- - - skuGroupId Number 1 属性组id
- - - skuAttributeId Number 1 属性名id
- - - skuAttributeValueId Number 0 属性值id
- - - skuGroupName String 属性组 属性组名
- - - skuAttributeName String 属性名 属性名
- - - skuaAtributeValue String 属性值 属性值 / 用户手动输入
- skuMarketings java.util.List sku营销标签集合,最多不限
- - - skuMarketingId1 Number 1 营销标签一级id
- - - skuMarketingId2 Number 1 营销标签二级id
- - - skuMarketingId3 Number 1 营销标签三级id
- - - skuMarketingName1 String 营销标签1 营销标签一级名称
- - - skuMarketingName2 String 营销标签2 营销标签二级名称
- - - skuMarketingName3 String 营销标签3 营销标签三级名称
tempId String 1 临时Id
venderName String XXX商家 商家名称
brand WarePreDetectRequest$Brand 品牌信息
- cn String 耐克 中文品牌信息,默认为空字符串
- en String nick 英文品牌信息,默认为空字符串
- full String 耐克nick 中英品牌信息,默认为空字符串
skuImages java.util.Set sku图片jsf url集合,最多不限
- - - String jfs/t1/…
attrs java.util.List 属性集合,最多不限
- - - groupId Number 1 属性组id
- - - attributeId Number 1 属性名id
- - - attributeValueId Number 0 属性值id
- - - groupName String 主体 属性组名
- - - attributeName String 型号 属性名
- - - attributeValue String 小型 属性值 / 用户手动输入
marketings java.util.List 营销标签集合,最多不限
- - - marketingId1 Number 1 营销标签一级id
- - - marketingId2 Number 1 营销标签二级id
- - - marketingId3 Number 1 营销标签三级id
- - - marketingName1 String 营销标签1 营销标签一级名称
- - - marketingName2 String 营销标签2 营销标签二级名称
- - - marketingName3 String 营销标签3 营销标签三级名称
draft Boolean false 如果是草稿信息检测,则传true

2. 请求示例代码(Java)

请求示例代码

 @Test
        public void     JDPopWarePreDetect() throws Exception {
        String strRequest = "{\"i18nParam\":{\"country\": \"zh\"},\"request\":{\"wareId\":10025693344516,\"thirdCid\":100001,\"payFirst\":0,\"giftGoods\":1,\"brandId\":200002,\"adWords\":\"Discover our latest collection\",\"slogan\":\"Innovate Your Lifestyle\",\"appDescImages\":[\"app_image1.png\",\"app_image2.png\"],\"shopId\":300003,\"firstCid\":400004,\"secondCid\":500005,\"hrefSlogan\":\"Explore More\",\"productArea\":\"Home Appliances\",\"appDescText\":\"Experience the future of home comfort\",\"source\":2,\"wareName\":\"Smart Refrigerator\",\"unLimitCid\":600006,\"shopName\":\"Modern Living\",\"factoryShip\":0,\"skus\":[{\"skuId\":\"FRIDGE-SKU-001\",\"color\":\"Stainless Steel\",\"size\":\"Large\",\"images\":[\"sku_image1.jpg\",\"sku_image2.jpg\"]}],\"tempId\":\"temp_78910\",\"venderName\":\"Tech Innovations\"}}";
        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("content", strRequest);
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDPopWarePreDetect, data);
    }

3. 返回结果如下:

{
    "code": 0,
    "message": "ok",
    "data": {
    "---": {
        "detectResult": "0",
        "reason": "滥发信息-发布信息不合规",
        "fields": [{
            "---": "wareName"
        }],
        "detectedValue": "我是标题"
    }
}
}

说明: code为0表示成功,非0为失败,message会包含失败原因。

4. 返回字段说明

名称 类型 示例值 描述
sku com.jd.pop.ware.ic.api.domain.Sku sku对象
- wareId Number 1 商品ID
- skuId Number 1 skuId
- status Number 1 状态,只读属性. 1:上架 2:下架 4:删除
saleAttrs java.util.Set 销售属性集合
com.jd.pop.ware.ic.api.domain.Prop
- attrId String 属性ID
- attrValueAlias String[] 属性值的描述或者别名
- attrValues String[] 属性值ID数组
- index Number 1 销售属性排序
features java.util.Set 特殊属性集合
com.jd.pop.ware.ic.api.domain.Feature
- featureCn String 特殊属性中文含义
- featureKey String 特殊属性key
- featureValue String 特殊属性value
- jdPrice Number 1 京东价
- outerId String 外部ID
- barCode String sku条形码
- categoryId Number 1 3级类目id
- imgTag Number 1 图片标签
- logo String sku颜色的主图
- skuName String sku名称
- stockNum Number 1 总库存数,仅用于非分区的SOP库存,分区库存需要调用库存查询接口
- wareTitle String 商品名称
- fixedDeliveryTime String 大件商品固定发货时效 格式:订单开始日期,订单结束日期,发货日期,完成发货天数
- relativeDeliveryTime String 大件商品相对发货时效(完成发货天数)
- parentId Number 1 父id
- modified Date 2019-01-01 01:01:01 修改时间
- created Date 2019-01-01 01:01:01 创建时间
multiCateProps java.util.Set 多级SKU属性
com.jd.pop.ware.ic.api.domain.Prop
- attrValueAlias String[] 值别名
- attrId String 属性ID
- attrValues String[] 属性值
- expands String[] expands 属性值扩展字段
- units String[] units 属性值单位
props java.util.Set SKU属性(已废弃)
com.jd.pop.ware.ic.api.domain.Prop
- attrValueAlias String[] 值别名
- attrId String 属性ID
- attrValues String[] 属性值
- capacity String 20L 20T 容量,在有特殊要求的类目下必填!最多支持6位小数。
- promiseId Number 12345678 时效运费模板id
文档更新时间: 2024-06-28 16:37   作者:JSL