入库更新
特色栏目
系统参数
| 名称 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| appid 复制 | Int | 是 | 您在京推推申请的appid | |
| appkey 复制 | String | 是 | 您在京推推申请的appkey | |
| v 复制 | String | 是 | API接口版本号，当前版本: v3 | |
| return_type 复制 | String | 否 | 返回数据格式，不传参默认json,支持以下参数code、jsonp、code_jsonp |
请求参数说明
| 名称 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| skuIds 复制 | String | 是 | 商品sku搜索，最高可输入100个，多sku搜索时请用英文逗号分割 （注：1、v1.0版本支持传商品链接；2、如果输入的sku串中某个skuID的商品不在推广中[就是没有佣金]，返回结果会自动过滤该商品） |
返回参数说明
| 名称 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| return 复制 | Int | 0=返回成功 | |
| result 复制 | Array | 返回结果 | |
| > goods_id 复制 | Long | 45513672478 | 商品SKU |
| > goods_name 复制 | String | 猎远 速干裤男快干裤春夏季户外运动裤情侣款 吸湿透气散热微弹力抗皱面料修身长裤子束脚裤 1825 浅灰色-1825款 M | 京东商品原标题 |
| > imgUrl 复制 | String | http://img14.360buyimg.com/n1/jfs/t1/56412/16/341/89816/5cd45eceE845ecc19/35fde2fff8491fbf.jpg | 图片地址（京东商品原主图） |
| > goods_link 复制 | String | http://item.jd.com/45513672478.html | 京东商品链接 |
| > goods_price 复制 | Double | 119 | 商品单价即京东价 |
| > wlUnitPrice 复制 | Double | 119 | 商品无线京东价（单价为-1表示未查询到该商品单价） |
| > commisionRatioPc 复制 | Double | 20 | PC佣金比例 |
| > commisionRatioWl 复制 | Double | 20 | 无线佣金比例 |
| > endTime 复制 | Long | 32472115200000 | 推广结束日期(java精确到毫秒，其他语言都可以精确到秒) |
| > startTime 复制 | Long | 1583769600000 | 推广开始日期(java精确到毫秒，其他语言都可以精确到秒) |
| > shop_id 复制 | Int | 698468 | 店铺ID |
| > vid 复制 | Long | 698468 | 商家ID |
| > inOrderCount30Days 复制 | Int | 1640 | 京东商品近30天销量 |
| > cid1 复制 | Int | 15901 | 京东一级类目ID |
| > cid1Name 复制 | String | 家庭清洁/纸品 | 京东一级类目名称 |
| > cid2 复制 | Int | 15902 | 京东二级类目ID |
| > cid2Name 复制 | String | 清洁纸品 | 京东二级类目名称 |
| > cid3 复制 | Int | 15908 | 京东三级类目ID |
| > cid3Name 复制 | String | 抽纸 | 京东三级类目名称 |
| > isSeckill 复制 | Int | 0 | 是否为秒杀商品 |
| > isJdSale 复制 | Int | 0 | 是否自营 (1 - 是,0 - 否)，后续会废弃，请用owner |
| > isFreeFreightRisk 复制 | Int | 0 | 是否支持运费险(1:是,0:否) |
| > isFreeShipping 复制 | Int | 0 | 是否包邮(1:是,0:否,2:自营商品遵从主站包邮规则) |
JSON返回示例
{
"return": "0",
"result": [
{
"isFreeFreightRisk": 1,
"isFreeShipping": 1,
"commisionRatioWl": 20.1,
"commisionRatioPc": 20.1,
"imgUrl": "http://img14.360buyimg.com/n1/jfs/t1/166904/33/2304/180737/5ffd4f38Ed8cf01d6/252ac84e96fc1c0b.jpg",
"vid": 593002,
"wlUnitPrice": 29.9,
"cid2Name": "护理护具",
"isSeckill": 0,
"cid2": 12190,
"cid3Name": "口罩",
"cid3": 1517,
"isJdSale": 0,
"goods_id": 10023641912338,
"goods_name": "医用外科口罩 独立包装】一次性使用成人男女挂耳式 灭菌级宏观蓝色 非白色 透气 隔离绒布口罩 40个/盒(单个独立包装)",
"goods_link": "http://item.jd.com/10023641912338.html",
"goods_price": 29.9,
"endTime": 1614268800000,
"startTime": 1613750400000,
"shop_id": 593002,
"cid1": 9192,
"cid1Name": "医疗保健",
"inOrderCount30Days": 153
}
]
}
v3版本 更新时间: 2021-02-25 09:45:47
v3更新内容
该版本功能与v2版本基本一致，该版本返回参数为京推推开放平台统一参数1 原skuId调整为goods_id：商品SKU
2 原goodsName调整为goods_name：京东商品原标题
3 原materialUrl调整为goods_link：京东商品链接
4 原unitPrice调整为goods_price：商品单价即京东价
5 原endDate调整为endTime：推广结束日期
6 原startDate调整为startTime：推广开始日期
7 原shopid调整为shop_id：店铺ID
8 原cid调整为cid1
9 原cidName调整为cid1Name
10 原 inOrderCount调整为inOrderCount30Days：京东商品近30天销量
v2版本 更新时间: 2021-02-25 09:42:27
v2更新内容
1 请求参数gid调整为skuIds，支持多SKU调用2 返回参数增加vid商家ID
3 返回参数增加isFreeFreightRisk是否支持运费险
4 返回参数增加isFreeShipping是否包邮
| 错误码 | 说明 |
|---|---|
| 0 | 请求成功 |
| 1000 | appid或appkey错误 |
| 2000 | API次数调用超过上限 |
| 3000 | API权限不足 |
