l 接口名称
jingdong.imgzone.category.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分钟 |
format | String | 否 | 暂时只支持json |
v | String | 否 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
cate_name | String | 否 | 分类名称,自动过滤特殊字符 | |
parent_cate_id | Number | 否 | 父分类ID,为空默认添加顶级分类 |
l 返回结果
名称 | 类型 | 示例值 | 描述 |
return_code | Number | 返回码:1,操作成功;0,操作失败 | |
desc | String | 返回码为1时为操作成功,返回码为0时为操作失败原因 | |
cate_id | Number | 添加成功的分类ID |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.imgzone.picture.upload
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 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
image_data | byte[] | 是 | 图片二进制文件流,允许png、jpg、gif、jpeg、bmp图片格式,1M以内。 | |
picture_cate_id | Number | 否 | 上传到的图片分类ID,为空上传至 默认分类 | |
picture_name | String | 否 | 图片名称,不超过64字节,为空默认 未命名 |
l 返回结果
名称 | 类型 | 示例值 | 描述 |
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 |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.imgzone.picture.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分钟 |
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对应的图片已被删除)集合 | |
referenced | List | 删除失败的图片中,已被引用的图片ID集合 | |
fail | List |
| 删除过程中,出现系统异常的图片ID集合,可重试 |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.imgzone.category.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分钟 |
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时为操作失败原因 |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.imgzone.picture.query
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分钟 |
format | String | 否 | 暂时只支持json |
v | String | 否 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
picture_id | String | 否 | 图片ID | |
picture_cate_id | Number | 否 | 图片所属分类ID | |
picture_name | String | 否 | 图片名称,支持后模糊查询 | |
start_date | Date | 否 | 创建开始时间 | |
end_Date | Date | 否 | 结束创建时间 | |
page_num | Number | 否 | 页码值,对应分页结果页数,为空或非正整数时默认为1,超过最大页数返回空 | |
page_size | Number | 否 | 每页条数,为空或非正整数时默认为20,最多返回100条 |
l 返回结果
名称 | 类型 | 示例值 | 描述 |
return_code | Number | 返回码:1,操作成功;0,操作失败 | |
desc | String | 返回码为1时为操作成功,返回码为0时为操作失败原因 | |
total_num | Number | 查询图片的总数 | |
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 | 图片修改时间 |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.imgzone.category.query
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分钟 |
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集合 |
对象说明
名称 | 类型 | 示例值 | 描述 |
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 |
| 修改时间 |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
接口名称
jingdong.imgzone.picture.update名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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时为操作失败原因 |
{ "jingdong_imgzone_picture_update_response":{ "desc":"", "return_code":"" } } |
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); |
接口名称
jingdong.imgzone.picture.replace名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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时为操作失败原因 |
{ "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); |
接口名称
jingdong.imgzone.userinfo.query名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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 | 用户详情 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
name | String | 否 | 空间名称 | |
used_size | Number | 否 | 已使用容量,单位kb | |
total_size | Number | 否 | 总容量,单位kb | |
created | Date | 否 | 图片空间创建用户时间 |
{ "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); |
接口名称
jingdong.imgzone.picture.isreferenced名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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,未引用 |
{ "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); |