文档中心 > API类目 > 多媒体平台API

taobao.picture.category.get (获取图片分类信息)

获取图片分类信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
picture_category_id Number 可选 100 图片分类ID
picture_category_name String 可选 分类 图片分类名,不支持模糊查询
type String 可选 1 1
parent_id Number 可选 0
  • 默认值:-1
  • 取二级分类时设置为对应父分类id 取一级分类时父分类id设为0 取全部分类的时候不设或设为-1
    modified_time Date 可选 2011-01-01 11:11:11 图片分类的修改时间点,格式:yyyy-MM-dd HH:mm:ss。查询此修改时间点之后到目前的图片分类。

    响应参数

    名称 类型 示例值 描述
    picture_categories PictureCategory [] 图片分类
    • └ picture_category_id
    • Number
    • 1234
    • 图片分类ID
    • └ picture_category_name
    • String
    • 名称
    • 图片分类名
    • └ position
    • Number
    • 1
    • 图片分类排序
    • └ type
    • String
    • sys-fixture
    • 图片分类型别,sys-fixture代表店铺装修分类(系统分类),sys-auction代表宝贝图片分类(系统分类),user-define代表用户自定义分类
    • └ total
    • Number
    • 100
    • 分类下的图片数
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 图片类目的创建时间
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 图片分类的修改时间
    • └ parent_id
    • Number
    • 0
    • 一级分类的parent_id为0 二级分类的则为其父分类的picture_category_id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    PictureCategoryGetRequest req = new PictureCategoryGetRequest();
    req.setPictureCategoryId(100L);
    req.setPictureCategoryName("分类");
    req.setType("1");
    req.setParentId(0L);
    req.setModifiedTime(StringUtils.parseDateTime("2011-01-01 11:11:11"));
    PictureCategoryGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <picture_category_get_response>
        <picture_categories>
            <picture_category>
                <picture_category_id>1234</picture_category_id>
                <picture_category_name>名称</picture_category_name>
                <position>1</position>
                <type>sys-fixture</type>
                <total>100</total>
                <created>2000-01-01 00:00:00</created>
                <modified>2000-01-01 00:00:00</modified>
                <parent_id>0</parent_id>
            </picture_category>
        </picture_categories>
    </picture_category_get_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部