京东接口接入分享

京东接口简要说明

由于京东方面没有上线cps服务的SDK实例，只能通过直接调用京东处接口实现功能。另外cps服务暂时还没有沙箱测试环境，所用的为正式环境。

 

联盟推广商品查询

接口名称：

jingdong.union.promotiongood.query

 

功能说明：

查询相关的商品推广数据

 

API用户授权类型：

不需要

 

系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	否	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否(但url中需要输入)	API协议版本，可选值:2.0

 

附:sign的生成方式

调用API接口时需要对请求参数进行签名验证，调用时也会对请求参数进行验证是否合法。

加密规则

① 所有请求参数按照字母先后顺序排列

例如：将access_token,app_key,method,timestamp,v 排序为access_token,app_key,method,timestamp,v)

②把所有参数名和参数值串在一起

例如：access_tokenxxxapp_keyxxxmethodxxxxxxtimestampxxxxxxvx

③把appSecret夹在字符串的两端

例如：appSecret+XXXX+appSecret

④使用MD5进行加密，再转化成大写

示例

调用api：360buy.order.search，以下示例只体现逻辑，假设app_key=yourappkey；appSecret=yourappSecret；access_token=yourtoken

①输入参数

access_token= yourtoken
app_key=yourappkey
method=360buy.order.search
timestamp=2011-07-20 11:10:04
v=2.0
360buy_param_json=  
{
    “end_date”:”2012-05-16 17:03:56”,
    “optional_fields”:”vender_id,
   order_id,pay_type,order_total_price,freight_price,seller_discount,order_payment,
   delivery_type,order_state,order_state_remark,invoice_info,order_remark,order_start_time,
    order_end_time,consignee_info,item_info_list”,
     “order_state”:  “WAIT_SELLER_STOCK_OUT”,
    “page”:”1”,
    “page_size”:”20”,
    “start_date”:”2012-05-14 17:03:56”
}

②把参数按照字母顺序排列

360buy_param_json= 
{

“end_date”:”2012-05-1617:03:56”,
    “optional_fields”:”vender_id,
   order_id,pay_type,order_total_price,freight_price,seller_discount,order_payment,
   delivery_type,order_state,order_state_remark,invoice_info,order_remark,order_start_time,
    order_end_time,consignee_info,item_info_list”,
     “order_state”:  “WAIT_SELLER_STOCK_OUT”,
    “page”:”1”,
    “page_size”:”20”,
    “start_date”:”2012-05-14 17:03:56”

}
access_token=yourtoken
app_key=yourappkey 
method=360buy.order.search
timestamp=2011-07-20 11:10:04
v=2.0

③连接参数名与参数值,并在首尾加上appSecret

yourappSecret360buy_param_json{“end_date”:null,”optional_fields”:null,”order_state”:”WAIT_SELLER_STOCK_OUT”,”page”:”1”,

“page_size”:”200”,”start_date”:null}access_tokenyourtokenapp_keyyourappkeymethod360buy.order.search

timestamp2012-06-2116:28:02v2.0yourappSecret

以上字符串是没有跨行的粘贴时请注意，除日期和时间中间的空格之外不允许在其它位置出现空格

④MD5加密后转成大写：CDBAFD499D419FA8F1669BDE8CEFE015

注意:应用级参数应该放入json对象为360buy_param_json中才能生成对应签名。

 

应用级输入参数

名称	类型	是否必须	示例值	描述
keywords	String	否		商品标题包含关键词,如果good_keywords和good_categoryId不填或者没有相匹配的查询结果,则会返回默认的推广数据
categoryId	Number	否		商品类目ID,如果good_keywords和good_categoryId不填或者没有相匹配的查询结果,则会返回默认的推广数据
property	String	否	price/commisionRatio/promotionQuantity	排序列的属性名,默认值commisionRatio
sort	String	否	DESC/ASC	升序或降序排列,默认值DESC
pageIndex	Number	是		结果页数
pageSize	Number	是		每页放回的结果数,每页上限为20
fields	Number	否(但如果为否则无法成功调用)	good_pk,good_skuId,good_shopName, good_name,good_price,good_praiseDegree, good_targetUrl,good_shopUrl,good_materialUrl, good_commRatio,good_commision, good_promQuantity,good_startDate,good_endDate, totalCount	需要返回的字段列表

 

返回结果

名称	类型	示例值	描述
good_list	GoodSafVo[ ]		商品推广对象列表
totalCount	Number		总个数,如果为null和设置field时没有设置该属性则在结果中不显示
isDefault	Boolean	返回的结果是否是默认的推广数据

GoodSafVo（商品推广对象列表）

名称	类型	是否必须	示例值	描述
good_pk	Number	否		主键
good_skuId	Number	否		sku id
good_shopName	String	否		商家名称,如果为null和设置field时没有设置 该属性则在结果中不显示
good_name	String	否	商品标题名称,如果为null和设置field时没有设置该属性则在结果中不显示
good_price	Number	否		商品价格
good_praiseDegree	Number	否		好评度
good_targetUrl	String	否		目标页URL,如果为null和设置field时没有设置该属性则在结果中不显示
Good_shopUrl （但具体无法返回该url）	String	否		店铺URL,如果为null和设置field时没有设置该属性则在结果中不显示
good_materialUrl	String	否		商品主图素材URL,如果为null和设置field时没有设置该属性则在结果中不显示
good_commRatio	Number	否		佣金比例
good_commision	Number	否		佣金
good_promQuantity	Number	否		30天内的交易量
good_startDate	String	否		推广开始时间,yyyy-MM-ddHH:mm:ss
good_endDate	String	否		推广结束时间,yyyy-MM-ddHH:mm:ss

 

返回示例

JSON数据格式

{     "jingdong_union_promotiongood_query_response": {         "msg": {             "isDefault": "",             "totalCount": "",             "good_list": {                 "good_endDate": "",                 "good_shopName": "",                 "good_targetUrl": "",                 "good_materialUrl": "",                 "good_promQuantity": "",                 "good_praiseDegree": "",                 "good_startDate": "",                 "good_name": "",                 "good_commRatio": "",                 "good_price": "",                 "good_pk": "",                 "good_shopUrl": "",                 "good_commision": "",                 "good_skuId": ""             }         }     } }