服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

京东云服务

【类目服务】接口导航


1. 获取商家类目信息 2. 获取类目属性信息
3. 获取类目属性值信息 4. 查询商家已授权的品牌

1. 获取商家类目信息
  

l  接口名称 


      360buy.warecats.get


l  功能说明


        获取商家已开通的标准商品类目。


l  系统级别输入参数


名称

类型

是否必须

描述

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分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数 


名称

类型

是否必须

示例值

描述

fields

String

否

id,fid,status,lev,name,index_id

需返回的字段列表。未设置参数时,默认返回全部值


l  返回结果


名称

类型

是否必须

示例值

描述

item_cats

List<category>

是

 

类目信息

code

String

 

 

0为正常，其它值参见错误代码一览表


 category结构

名称

类型

示例值

描述

id

number

2323

类目id

index_id

number

12314

排序（越小越靠前）

fid

number

123122

父类目id

name

String

 

类目名称

is_parent

boolean

true

该类目是否为父类目(即：该类目是否还有子类目)

status

string

VALID

类目状态（DELETED，UNVALID, VALID）

lev

number

1

等级(类目分为1、2、3级)

 

l  返回示例 

JSON数据格式

{

    "ware_category_search_response": {

         "code": "0"

        "item_cats": [

            {

                "name": "高清播放器",

                "id": 1261,

                "status": "VALID",

                "lev": 3,

                "fid": 794

            },

            {

                "name": "面膜面贴",

                "id": 6543,

                "status": "VALID",

                "lev": 3,

                "fid": 6355

            },

            {

                "name": "T恤",

                "id": 1349,

                "status": "VALID",

                "lev": 3,

                "fid": 1342

            }         

        ],

        "total": 3,

    }

}

 

l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

CategorySearchRequest request = new CategorySearchRequest();

CategorySearchResponse response=client.execute(request);

  
2. 获取类目属性信息
  

l  接口名称

     360buy.ware.get.attribute 


l  功能说明 

      获取类目下的属性信息。

 

l  系统级别输入参数

 

名称

类型

是否必须

描述

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分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

fields

String

是

aid,name,is_key_prop,

is_sale_prop,index_id,status,

att_type,input_type,

is_req,is_fet,is_nav,cid

需返回的字段列表。

cid

number

是

 

类目id

is_key_prop

boolean

否

true

是否关键属性(true/false)

is_sale_prop

boolean

否

false

是否销售属性(true/false)

aid

number

否

 

属性id


l  返回结果


名称

类型

是否必须

示例值

描述

attributes

List

是

 

类目属性信息

attribute结构 

名称

类型

示例值

描述

aid

number

2323

属性id

name

string

12314

属性名

cid

string

1354

类目id

is_key_prop 

boolean

false

关键属性

is_sale_prop 

boolean

true

销售属性

is_color_propboolean

true

颜色属性。可选值:true(是),false(否)
is_size_propbooleantrue尺码属性。可选值:true(是),false(否)

index_id

number

 

排序(越小越靠前)

status

string


状态 

att_type 

string

 

属性类型

1、关键属性2、不变属性3、可变属性4、销售属性

input_type 

number

 

输入类型( 1、单选， 2、多选3、输入(最大50个字符) )

is_req 

string

true

是否必填 

is_fet 

string

true

是否筛选

is_nav 

string

true

是否导航


l  返回示例 


       JSON数据格式 

{

    "category_attribute_search_response": {

        "code": "0"

        "attributes": [

            {

                "name": "价格",

                "status": "valid",

                "input_type": 1,

                "cid": "1575",

                "index_id": 1,

                "aid": 3756,

                "att_type": "3",

                "is_req": "false",

                "is_fet": "true",

                "is_nav": "false"

            },

            {

                "name": "品牌",

                "status": "valid",

                "input_type": 1,

                "cid": "1575",

                "index_id": 1,

                "aid": 3755,

                "att_type": "3",

                "is_req": "false",

                "is_fet": "true",

                "is_nav": "false"

            }

        ],

        "total": 2,

    }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

CategoryAttributeSearchRequest request = new CategoryAttributeSearchRequest();

request.setCid("4001");

CategoryAttributeSearchResponse response=client.execute(request);

  
3. 获取类目属性值信息
  

l  接口名称

     360buy.ware.get.attvalue

 

l  功能说明

     获取类目下的属性值信息。

 

l  系统级别输入参数 


名称

类型

是否必须

描述

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分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

fields

String

是

aid,vid,name,status,index_id

需返回的字段列表。

avs

string

是

 

属性和属性值 id串，格式例如(aid)或(aid;aid)或(aid:vid)或(aid:vid;aid:vid)或(aid;aid:vid)


 

l  返回结果


名称

类型

是否必须

示例值

描述

att_values

List

是

 

类目属性值信息

AttValue结构

名称

类型

示例值

描述

aid

number

2323

属性id

vid

number

12314

属性值id

品牌属性值ID请通过下面的接口获取jingdong.pop.vender.cener.venderBrand.query

name

string

 

属性值名字

status

string

unvalid

状态（deleted，unvalid，valid）

index_id

number

 

排序(越小越靠前)


l  返回示例

JSON数据格式

{

 "category_attribute_value_response": {

   "code":"0"

"att_values":[

     {

         "name":"0-99",

         "status":"valid",

         "index_id":1,

         "aid":3206,

         "vid":22106

        },

        {

        "name":"秋水之韵",

        "status":"valid",

        "index_id":91,

        "aid":3205,

        "vid":65556

        }

        

   ],

   "total":2,

   }

}



l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

CategoryAttributeValueSearchRequest request = new CategoryAttributeValueSearchRequest();

request.setAvs("8739");

CategoryAttributeValueSearchResponse response=client.execute(request);

  
4. 查询商家已授权的品牌
  

l  接口名称

jingdong.pop.vender.cener.venderBrand.query

 

l  功能说明 

      查询商家已授权的品牌

 

l  系统级别输入参数

 

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

 

l  应用级输入参数

 

名称 类型 是否必须 示例值 描述
name  String  否   品牌名称，支持模糊查询 

 

l  返回结果

名称 类型 示例值 描述
brandList  VenderBrandPubInfo[]    商家品牌List集合 

VenderBrandPubInfo属性 

名称 类型 是否必须 示例值 描述
erpBrandId  Number  否   ERP品牌ID 
brandName  String  否   品牌名称 

 

l  返回示例 

       JSON数据格式 

{
  "jingdong_pop_vender_cener_venderBrand_query_response":{
  "brandList":[{
  "erpBrandId":"",
"brandName":""
  }]
  }
  } 


l  SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
PopVenderCenerVenderBrandQueryRequest request=new PopVenderCenerVenderBrandQueryRequest();
request.setName( "jingdong" );
PopVenderCenerVenderBrandQueryResponse response=client.execute(request);