1. 添加图片分类

接口名称 

jingdong.imgzone.category.add

功能说明

添加图片分类

系统级别输入参数 

名称

类型

是否必须

描述

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

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

应用级输入参数

名称

类型

是否必须

示例值

描述

cate_name String 分类名称,自动过滤特殊字符
parent_cate_id  Number 父分类ID,为空默认添加顶级分类

返回结果

名称

类型

示例值

描述

return_code Number 返回码:1,操作成功;0,操作失败
desc String 返回码为1时为操作成功,返回码为0时为操作失败原因
cate_id Number 添加成功的分类ID

返回示例

JSON数据格式

{
  "jingdong_imgzone_category_add_response":{
  "desc":"",
"cate_id":"",
"return_code":""
  }
  }

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ImgzoneCategoryAddRequest request=new ImgzoneCategoryAddRequest();
request.setCateName( "jingdong" );
request.setParentCateId( 123 );
ImgzoneCategoryAddResponse response=client.execute(request);

  
2. 上传单张图片

接口名称 

jingdong.imgzone.picture.upload

 

功能说明

上传单张图片

 

系统级别输入参数 

名称

类型

是否必须

描述

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.

应用级输入参数

名称

类型

是否必须

示例值

描述

image_data byte[] 图片二进制文件流,允许png、jpg、gif、jpeg、bmp图片格式,1M以内。
picture_cate_id Number 上传到的图片分类ID,为空上传至 默认分类
picture_name  String 图片名称,不超过64字节,为空默认 未命名

返回结果

名称

类型

示例值

描述

return_code Number 返回码:1,操作成功;0,操作失败
desc  String   返回码为1时为操作成功,返回码为0时为操作失败原因
picture_id  String   上传成功的图片id
picture_url String 

上传成功的图片url


以业务名开头,如g0/M0/00/00/xx.jpg,使用时需加上前缀:http://域名/imgzone/,其中域名可为: img10/img11/img12/img13/img14/img20/img30.360buyimg.com 等。

如需要引用不同大小的图片,只需在类似 http://img10.360buyimg.com/imgzone/之后加上规定的尺寸大小即可。

图片空间支持的尺寸有:800x800, 160x160, 130x130, 100x100, 50x50, 800x600, 347x260, 150x113, 130x98, 50x38, 350x350, 100x75, 0x0, 350x450, 220x283, 50x64

引入示例(正常): http://img10.360buyimg.com/imgzone/g0/M0/00/00/xx.jpg

指定尺寸:http://img10.360buyimg.com/imgzone/s800x800_g0/M0/00/00/xx.jpg


返回示例

JSON数据格式

{
  "jingdong_imgzone_picture_upload_response":{
  "desc":"",
"picture_url":"",
"picture_id": "",
"return_code":""
  }
  }

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ImgzonePictureUploadRequest request=new ImgzonePictureUploadRequest();
request.setImageData( "txt" );
request.setPictureCateId( 123 );
request.setPictureName( "jingdong" );
ImgzonePictureUploadResponse response=client.execute(request);

  
3. 删除图片

接口名称 

jingdong.imgzone.picture.delete

功能说明

删除图片

系统级别输入参数 

名称

类型

是否必须

描述

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

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

 l  应用级输入参数

名称

类型

是否必须

示例值

描述

picture_ids 

String

 

图片ID,批量删除时ID间以半角逗号分隔,已被引用的图片不能删除 

 l  返回结果

名称

类型

示例值

描述

return_code 

Number

 

返回码:1,操作成功;0,操作失败;2,部分操作成功 
desc String 返回码为1时为操作成功,返回码为0时为全部删除失败,返回码为2时为部分删除成功
success_num Number 成功删除数
illegal List 删除失败的图片中,非法的图片ID(图片ID不存在,或者此ID对应的图片已被删除)集合
referencedList 删除失败的图片中,已被引用的图片ID集合

fail

List

 

删除过程中,出现系统异常的图片ID集合,可重试

返回示例

JSON数据格式

{
  "jingdong_imgzone_picture_delete_response":{
  "desc":"",
"fail":[{
  
  }],
"illegal":[{
  
  }],
"return_code":"",
"referenced":[{
  
  }],
"success_num":""
  }
  }

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ImgzonePictureDeleteRequest request=new ImgzonePictureDeleteRequest();
request.setPictureIds( "jingdong" );
ImgzonePictureDeleteResponse response=client.execute(request);

  
4. 更新图片分类

接口名称 

jingdong.imgzone.category.update

功能说明

更新图片分类

系统级别输入参数 

名称

类型

是否必须

描述

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

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

 l  应用级输入参数

名称

类型

是否必须

示例值

描述

cate_id 

Number

要更新的分类ID 

cate_name String 新的分类名称,自动过滤特殊字符,与新父分类ID不能同时为空

parent_cate_id 

Number

分类的新父分类ID,只能移动二级分类至默认分类或一级父分类,与新分类名称不能同时为空 

 l  返回结果

名称

类型

示例值

描述

return_code 

Number

 

返回码:1,操作成功;0,操作失败 
desc String 为1时为操作成功,返回码为0时为操作失败原因 

返回示例

JSON数据格式

{
  "jingdong_imgzone_category_update_response":{
  "desc":"",
"return_code":""
  }
 }

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ImgzoneCategoryUpdateRequest request=new ImgzoneCategoryUpdateRequest();
request.setCateId( 123 );
request.setCateName( "jingdong" );
request.setParentCateId( 123 );
ImgzoneCategoryUpdateResponse response=client.execute(request);

  
5. 查询图片

接口名称 

jingdong.imgzone.picture.query

功能说明

查询图片

系统级别输入参数 

名称

类型

是否必须

描述

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

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

应用级输入参数

名称

类型

是否必须

示例值

描述

picture_id String 图片ID
picture_cate_id Number 图片所属分类ID
picture_name String 图片名称,支持后模糊查询
start_date Date 创建开始时间
end_Date Date 结束创建时间
page_num Number 页码值,对应分页结果页数,为空或非正整数时默认为1,超过最大页数返回空
page_sizeNumber 每页条数,为空或非正整数时默认为20,最多返回100条

返回结果

名称

类型

示例值

描述

return_code Number 返回码:1,操作成功;0,操作失败
desc String 返回码为1时为操作成功,返回码为0时为操作失败原因
total_numNumber 查询图片的总数
imgList ImgzoneImgInfo[] 图片List集合

 对象说明

ImgzoneImgInfo[]属性:

名称

类型

示例值

描述

picture_id  String   图片ID 
picture_cate_id  Number   图片所属分类ID
picture_url  String   图片url,以业务名开头,如g0/M0/00/00/xx.jpg,使用时需加上前缀:http://域名/imgzone/,其中域名可为: img10/img11/img12/img13/img14/img20/img30.360buyimg.com 等。 如需要引用不同大小的图片,只需在类似 http://img10.360buyimg.com/imgzone/ 之后加上规定的尺寸大小即可,图片空间支持的尺寸有:800x800, 160x160, 130x130, 100x100, 50x50, 800x600, 347x260, 150x113, 130x98, 50x38, 350x350, 100x75, 0x0, 350x450, 220x283, 50x64,引入示例: 正常:http://img10.360buyimg.com/imgzone/g0/M0/00/00/xx.jpg 指定尺寸:http://img10.360buyimg.com/imgzone/s800x800_g0/M0/00/00/xx.jpg   
picture_name  String   图片名称 
picture_type  String   图片后缀
referenced  Number   是否被引用:1,是;0,否 
picture_size  Number   图片大小,单位b
picture_width  Number   图片宽度,单位px 
picture_height  Number   图片高度,单位px 
created  Date   图片创建时间 
modified  Date   图片修改时间

 

返回示例

JSON数据格式

{
  "jingdong_imgzone_picture_query_response":{
 "imgList":[{
  "picture_size":"",
"picture_url":"",
"created":"",
"picture_height":"",
"picture_type":"",
"picture_width":"",
"picture_id":"",
"picture_name":"",
"referenced":"",
"modified":"",
"picture_cate_id":""
  }],
"desc":"",
"total_num":"",
"return_code":""
  }
  }

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ImgzonePictureQueryRequest request=new ImgzonePictureQueryRequest();
request.setPictureId( "jingdong" );
request.setPictureCateId( 123 );
request.setPictureName( "jingdong" );
request.setStartDate( "2012-12-12 12:12:12" );
request.setEndDate( "2012-12-12 12:12:12" );
request.setPageNum( 123 );
request.setPageSize( 123 );
ImgzonePictureQueryResponse response=client.execute(request);

  
5. 查询图片分类

接口名称 

jingdong.imgzone.category.query

功能说明

查询图片分类

系统级别输入参数 

名称

类型

是否必须

描述

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

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

 l  应用级输入参数

名称

类型

是否必须

示例值

描述

cate_id 

Number

1

分类ID 

cate_name String分类名abc分类名称,不支持模糊查询 

parent_cate_id 

Number

1

父分类ID,查询二级分类时为对应父分类id,查询一级分类时为0,查询全部分类的时候为空 

 l  返回结果

名称

类型

示例值

描述

return_code 

Number

 

返回码:1,操作成功;0,操作失败 
desc String 操作结果,返回码为1时为操作成功,返回码为0时为操作失败原因
cateList ImgzoneCategory[]   分类List集合

对象说明

ImgzoneCategory[] 属性:

名称

类型

示例值

描述

cate_id  Number   分类ID
cate_name  String   分类名称
cate_level  Number   分类层级,默认分类为0,父分类为1,子分类为2
parent_cate_id  Number   父分类ID
cate_order  Number   同级分类排序值,正整数,唯一但不一定连续 
created  Date   创建时间

modified 

Date

 

修改时间

 

返回示例

JSON数据格式

{
  "jingdong_imgzone_category_query_response":{
 "desc":"",
"cateList":[{
  "cate_level":"",
"parent_cate_id":"",
"created":"",
"cate_order":"",
"cate_id":"",
"modified":"",
"cate_name":""
  }],
"return_code":""
  }
  }

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ImgzoneCategoryQueryRequest request=new ImgzoneCategoryQueryRequest();
request.setCateId( 123 );
request.setCateName( "jingdong" );
request.setParentCateId( 123 );
ImgzoneCategoryQueryResponse response=client.execute(request);

6. 更新图片

接口名称

jingdong.imgzone.picture.update

API用户授权类型

需要

系统级别输入参数

名称 类型 是否必须 描述
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

应用级输入参数

名称 类型 是否必须 示例值 描述
picture_id  String 
图片ID 
picture_name  String 
新的图片名称,不能超过64个字节,与新的图片分类ID不能同时为空 
picture_cate_id  Number 
新的图片分类ID,与新的图片名称不能同时为空 

返回结果

名称 类型 示例值 描述
return_code  Number 
返回码:1,操作成功;0,操作失败 
desc  String 
返回码为1时为操作成功,返回码为0时为操作失败原因 

返回示例

JSON数据格式

{
  "jingdong_imgzone_picture_update_response":{
  "desc":"",
"return_code":""
  }

  }


SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ImgzonePictureUpdateRequest request=new ImgzonePictureUpdateRequest();
request.setPictureId( "jingdong" );
request.setPictureName( "jingdong" );
request.setPictureCateId( 123 );
ImgzonePictureUpdateResponse response=client.execute(request);

8. 替换图片

接口名称

jingdong.imgzone.picture.replace

API用户授权类型

需要

系统级别输入参数

名称 类型 是否必须 描述
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

应用级输入参数

名称 类型 是否必须 示例值 描述
picture_id  String 
图片ID 
image_data  byte[] 
图片二进制文件流,允许png、jpg、gif、jpeg、bmp图片格式,1M以内。  

返回结果

名称 类型 示例值 描述
return_code  Number 
返回码:1,操作成功;0,操作失败 
desc  String 
返回码为1时为操作成功,返回码为0时为操作失败原因 

返回示例

JSON数据格式

{
  "jingdong_imgzone_picture_replace_response":{
  "desc":"",
"return_code":""
  }

  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ImgzonePictureReplaceRequest request=new ImgzonePictureReplaceRequest();
request.setPictureId( "jingdong" );
request.setImageData( "txt" );
ImgzonePictureReplaceResponse response=client.execute(request);

9. 查询图片空间用户信息

接口名称

jingdong.imgzone.userinfo.query

API用户授权类型

需要

系统级别输入参数

名称 类型 是否必须 描述
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

应用级输入参数

名称 类型 是否必须 示例值 描述

返回结果

名称 类型 示例值 描述
return_code  Number 
返回码:1,操作成功;0,操作失败 
desc  String 
操作结果,返回码为1时为操作成功,返回码为0时为操作失败原因 
userInfo  ImgzoneZoneInfo 
用户详情 

ImgzoneZoneInfo 属性

名称 类型 是否必须 示例值 描述
name  String 
空间名称 
used_size  Number 
已使用容量,单位kb 
total_size  Number 
总容量,单位kb 
created  Date 
图片空间创建用户时间 

返回示例

JSON数据格式

{
  "jingdong_imgzone_userinfo_query_response":{
  "desc":"",
"userInfo":{
  "used_size":"",
"created":"",
"total_size":"",
"name":""
  },
"return_code":""
  }
  }

SDK调用示例

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

10. 查询图片是否被引用

接口名称

jingdong.imgzone.picture.isreferenced

API用户授权类型

需要

系统级别输入参数

名称 类型 是否必须 描述
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

应用级输入参数

名称 类型 是否必须 示例值 描述
picture_id  String 
图片ID 

返回结果

名称 类型 示例值 描述
return_code  Number 
返回码:1,操作成功;0,操作失败;2,部分操作成功 
desc  String 
返回码为1时为操作成功,返回码为0为操作失败原因 
is_referenced  Boolean 
是否引用:true,已引用;false,未引用 

返回示例

JSON数据格式

{
  "jingdong_imgzone_picture_isreferenced_response":{
  "desc":"",
"is_referenced":"",
"return_code":""
  }

  }



SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ImgzonePictureIsreferencedRequest request=new ImgzonePictureIsreferencedRequest();
request.setPictureId( "jingdong" );
ImgzonePictureIsreferencedResponse response=client.execute(request);