发布商品前置检测接口
1.商品检测接口,会对传到接口内的商品标题,图片等进行合规性检查
1.请求参数:
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| 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