服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

京东云服务

【店铺服务】接口导航


1. 添加卖家自定义店内分类 2. 更新商家自定义店内分类
3. 删除商家自定义店内分类 4. 获取前台展示的商家自定义店内分类
5. 查询商家基本信息 6. 查询商家店铺基本信息

1. 添加卖家自定义店内分类
  

l  接口名称

     360buy.sellercat.add 


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  应用级输入参数


名称

类型

是否必须

示例值

描述

parent_id

String

是

12 

父类目编号，如果类目为店铺下的一级类目：值等于0，如果类目为子类目，调用获取360buy.warecats.get父类目编号

name

String

是

店铺类目

卖家自定义类目名称。

is_open

String

否

true

是否展开子分类（false，不展开；true，展开）

is_home_show

String

否

false

是否在首页展示分类（false，前台不展示，true前台展示）


l  返回结果

名称

类型

示例值

描述

create_time

String

2012-01-17 XX:XX

添加类目时间

cid

string

3206

创建的类目ID

code

string


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


l  返回示例 


       JSON数据格式 

{

        "catalog_add_response":{

                 "code":"0",

                 "cid":"3272",

                 "create_time":"2013-01-17 16:25:17"

         }

}


l  SDK调用示例（java）

 

public JdClient client = new DefaultJdClient(SERVER_URL,"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

SellerCatAddRequest request = new SellerCatAddRequest();

request.setHomeShow(false);

request.setName("star27");

request.setOpen(true);

request.setParentId("0");

SellerCatAddResponse response = client.execute(request);

  
2. 更新商家自定义店内分类
  

l  接口名称

     360buy.sellercat.update 


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  应用级输入参数


名称

类型

是否必须

示例值

描述

cid

String

是

1

类目ID

cat_name

String

否

店铺类目名称

卖家自定义类目名称

home_show

String

否

false

是否在首页展示分类（false，前台不展示，true前台展示）


l  返回结果

名称

类型

示例值

描述

cid

String


类目id

modified

string


更改时间

code

string


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


l  返回示例 


       JSON数据格式 

{

    "sellercat_update_response":{

            "code":"0",

            "modified":"2013-01-21 10:10:25",

            "cid":"125709"

    }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

SellerCatUpdateRequest request = new SellerCatUpdateRequest();

request.setCid("125709");

request.setName("手机(8080)");

request.setHomeShow(false);

SellerCatUpdateResponse response = client.execute(request);
  
3. 删除商家自定义店内分类
  

l  接口名称

     360buy.sellercat.delete 


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  应用级输入参数


名称

类型

是否必须

示例值

描述

cid

String

是

1

类目ID


l  返回结果

名称

类型

示例值

描述

cid

String


类目id

created

string


删除时间

code

string


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

 

l  返回示例 


       JSON数据格式 

{

   "sellercat_delete_response":{

           "code":"0",

           "created":"2013-01-21 10:10:25",

           "cid":"125709"

     }

}


l  SDK调用示例（java）



public JdClient client = new DefaultJdClient(SERVER_URL,"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

SellerCatDeleteRequest request=new SellerCatDeleteRequest();

request.setCid("125709");

SellerCatDeleteResponse response=client.execute(request); 

4. 获取前台展示的商家自定义店内分类

l  接口名称

     360buy.sellercats.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

否


可选字段


 

l  返回结果

名称

类型

示例值

描述

shopCats

List

 

 

店铺类目信息

ShopCategory结构

名称

类型

示例值

描述

cid

number


类目编号

parent_id

number


父类目编号

name

string

 

类目名称

is_parent

Boolean


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

is_open

Boolean

 

是否展开子分类

is_home_show

Boolean


是否在首页展示分类

shop_id

number

 

店铺ID

index_id

number

 

排序号

l  返回示例

JSON数据格式

{

        "sellercats_get_response":{

                  "code":"0",

                 "shopCats":[

                        {

                                 "cid":125709,

                                 "name":"手机（8080）",

                                 "parent_id":0,

                                 "shop_id":18333,

                                  "index_id": 0,

                                 "is_parent":true,

                                 "is_open":true,

                                 "is_home_show":false

                      },

                     {

                                 "cid":366117,

                                 "name":"背!@#%^*()-_=   心3",

                                 "parent_id":125711

                                 "shop_id":18333,

                                 "index_id": 0,

                                 "is_parent":false,

                                 "is_open":false,

                                 "is_home_show":false

                     },

                     {

                                 "cid":366118,

                                 "name":"背!@#%^*()-_=心4",

                                 "parent_id":125711,

                                 "shop_id":18333,

                                  "index_id": 0,

                                 "is_parent":false,

                                 "is_home_show":false

                     },

                    {

                                "cid":154707,

                                "name":"健康-   ---运动",

                                "parent_id":154585,

                                "shop_id":18333,

                                "index_id": 0,

                                "is_parent":false,

                                "is_open":false,

                                "is_home_show":false

                      }

             ]

      }

}



l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

SellerCatsGetRequest sellerCatsGetRequest = new SellerCatsGetRequest();

sellerCatsGetRequest.setFields("cid");

SellerCatsGetResponse

sellerCatsGetResponse = client.execute(sellerCatsGetRequest);

  
5. 查询商家基本信息
  

l  接口名称

     jingdong.seller.vender.info.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分钟

formatString否暂时只支持json

v

String

是

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


l  应用级输入参数


名称

类型

是否必须

示例值

描述


  


此接口无需输入应用级参数，但需要构建空参数360buy_param_json={}


l  返回结果

名称

类型

示例值

描述

vender_info_result

VenderInfoResult[ ]


商家信息

VenderInfoResult结构

名称

类型

是否必须

示例值

描述

vender_id

number

否


商家编号

col_type

number

否


商家类型

0：SOP
1：FBP
2：LBP
5：SOPL

shop_id

number

否

 

店铺编号

shop_name

String否


店铺名称

cate_main

number否

 

主营类目编号


l  返回示例 


       JSON数据格式 

{
  "jingdong_seller_vender_info_get_responce":{
  "vender_info_result":{
  "cate_main":"",
"shop_id":"",
"vender_id":"",
"col_type":"",
"shop_name":""
  }
  }
  }

l  SDK调用示例（java）

 

pulbic JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerVenderInfoGetRequest request=new SellerVenderInfoGetRequest();
request.setExt_json_param( "jingdong" );
SellerVenderInfoGetResponse response=client.execute(request);
6. 查询商家店铺基本信息
  

l  接口名称

     jingdong.vender.shop.query


l  功能说明 

     查询商家店铺基本信息，包括商家编号，店铺编号，店铺名称，开店时间，logoUrl，店铺简介，主营类目编号，主营类目名称

 

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  应用级输入参数


名称

类型

是否必须

示例值

描述


  


此接口无需输入应用级参数，但需要构建空参数360buy_param_json={}


l  返回结果

名称 类型 示例值 描述
shop_jos_result  ShopJosResult    店铺信息 

ShopJosResult 结构

名称 类型 是否必须 示例值 描述
vender_id  Number  否   商家编号 
shop_id  Number  否   店铺编号 
shop_name  String  否   店铺名称 
open_time  Date  否   开店时间 
logo_url  String  否   logo地址 
brief  String  否   店铺简介 
category_main  Number  否   主营类目编号 
category_main_name  String  否   主营类目名称 

l  返回示例 


       JSON数据格式 

{
"jingdong_vender_shop_query_response": {
"shop_jos_result": {
"open_time": "",
"shop_id": "",
"category_main_name": "",
"category_main": "",
"vender_id": "",
"brief": "",
"logo_url": "",
"shop_name": ""
}
}
}

l  SDK调用示例（java）

 

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
VenderShopQueryRequest request=new VenderShopQueryRequest();
VenderShopQueryResponse response=client.execute(request);