发布商品前置检测接口
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