关键词查询商品

websocket测试

POST

接口描述

jd.union.open.goods.query 关键词商品查询接口【申请】

请求头

参数名

类型

描述

必填

method

String

API接口名称

必填

app_key

String

应用的app_key

必填

timestamp

String

时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

必填

format

String

填“json”

必填

String

填“1.0”

必填

sign_method

String

填“md5”

必填

sign

String

API输入参数签名结果

必填

请求参数

参数名

类型

描述

必填

goodsReqDTO

GoodsReq

请求入参

必填

keyword

String

关键词，字数同京东商品名称一致，目前未限制

必填

pageIndex

Number

页码

必填

pageSize

Number

每页数量，单页数最大30，默认20

必填

isCoupon

Number

是否是优惠券商品，1：有优惠券，0：无优惠券

必填

pid

String

618_618_618 ：联盟id_应用iD_推广位id （这个字段是否需要待测试）

必填

响应参数

参数名

类型

描述

必填

queryResult

GoodsQueryResult

返回结果

必填

code

Number

返回码：200

必填

message

String

返回消息：success

必填

totalCount

Number

有效商品总数量，上限1w

必填

data

GoodsResp[]

数据明细

必填

goodsResp

GoodsResp

数据明细

必填

comments

Number

评论数

必填

couponInfo

CouponInfo

优惠券信息，返回内容为空说明该SKU无可用优惠券

必填

couponList

Coupon[]

优惠券集合

必填

coupon

Coupon

优惠券明细

必填

discount

Number

券面额【测试注意下单位，接口没有明确】

必填

platformType

Number

券使用平台 (平台类型：0 - 全平台券，1 - 限平台券) 【我们需要找全平台可用的】

必填

bindType

Number

券种类 (优惠券种类：0 - 全品类，1 - 限品类（自营商品），2 - 限店铺，3 - 店铺限商品券)

必填

link

String

券链接【转链时使用】eg:http://coupon.jd.com/ilink/couponActiveFront/front_index.action?XXXXXXX

必填

imageInfo

ImageInfo

图片信息

必填

imageList

UrlInfo[]

图片合集

必填

urlInfo

UrlInfo

图片合集

必填

url

String

图片链接地址，第一个图片链接为主图链接（https://img14.360buyimg.com/ads/jfs/t22495/56/628456568/380476/9befc935/5b39fb01N7d1af390.jpg ）【注意域名是否全】

必填

inOrderCount30Days

Number

30天引单数量

必填

priceInfo

com.jd.union.PriceInfo

价格信息

必填

lowestPrice

Number

最低价格

必填

lowestPriceType

Number

最低价格类型，1：无线价格；2：拼购价格； 3：秒杀价格

必填

lowestCouponPrice

Number

最低价后的优惠券价（是否为最低价+券后价格）

必填

shopInfo

com.jd.union.ShopInfo

店铺信息

必填

shopName

String

店铺名称（或供应商名称）

必填

skuId

Number

商品ID

必填

skuName

String

商品名称

必填