文档中心 > API类目 > 淘宝商品API

tmall.item.desc.modules.get (商品描述模块信息获取)

商品描述模块信息获取,包括运营设定的类目级别的模块信息以及用户自定义模块数量约束。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cat_id Number 必须 5567 淘宝后台发布商品的叶子类目id,可通过taobao.itemcats.get查到。api 访问地址http://api.taobao.com/apidoc/api.htm?spm=0.0.0.0.CFhhk4&path=cid:3-apiId:122
usr_id String 必须 28947 商家主帐号id

响应参数

名称 类型 示例值 描述
modular_desc_info ModularDescInfo 返回描述模块信息
  • └ usr_def_max_num
  • Number
  • 10
  • 用户自定义模块数量最大值限制。类目级别模块+用户级别模块必须小于<20
  • itm_dsc_modules
  • ItemDescModule []
  • 运营定义的该商品所属类目的类目级别模块信息列表,列表顺序即为模块顺序。
  • └ intros
  • String
  • [{"1.要好好填写"},{"2.不要乱写"},{"3.女模特漂亮点不然你死定了"}]
  • 一个List的Json串,里面是模块引导提示,不超过3条(isv提交时可忽略不传)
  • └ tpl_urls
  • String
  • [{"img.jpg"},{"img2.jpg"},{""img3.jpg}]
  • 淘宝图片空间的地址链接,示例模板,最多不超过三个(isv提交时可忽略不传)
  • └ module_id
  • Number
  • 1
  • 模块id ,(注意:用户自定义模块不用填此项。)
  • └ required
  • Boolean
  • true
  • 是否必填 (isv提交时可忽略不传)
  • └ module_name
  • String
  • 模特图
  • 模块名称
  • └ type
  • String
  • cat_mod
  • cat_mod:表示是运营设置的类目维度模块,usr_mod表示的是商家自定义模块。
  • └ content
  • String
  • 这是模特图的内容
  • 描述具体内容
  • └ dead_line
  • String
  • 2013年7月5号
  • 旧描述与新描述共存时间(切换时间)。
  • └ user_order
  • Boolean
  • false
  • 默认值为false,如果此字段为true,则卖家上传的模块化的描述信息可以自定义排序。

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallItemDescModulesGetRequest req = new TmallItemDescModulesGetRequest();
req.setCatId(5567L);
req.setUsrId("28947");
TmallItemDescModulesGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_item_desc_modules_get_response>
    <modular_desc_info>
        <usr_def_max_num>10</usr_def_max_num>
        <itm_dsc_modules>
            <item_desc_module>
                <intros>[{&quot;1.要好好填写&quot;},{&quot;2.不要乱写&quot;},{&quot;3.女模特漂亮点不然你死定了&quot;}]</intros>
                <tpl_urls>[{&quot;img.jpg&quot;},{&quot;img2.jpg&quot;},{&quot;&quot;img3.jpg}]</tpl_urls>
                <module_id>1</module_id>
                <required>true</required>
                <module_name>模特图</module_name>
                <type>cat_mod</type>
                <content>这是模特图的内容</content>
            </item_desc_module>
        </itm_dsc_modules>
        <dead_line>2013年7月5号</dead_line>
        <user_order>false</user_order>
    </modular_desc_info>
</tmall_item_desc_modules_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>

错误码解释

错误码 错误描述 解决方案
isv.error-get-modular-desc-info 系统错误,获取商品描述模块信息失败! 请稍候重试或联系管理员。

API工具

如何获得此API

FAQ

返回
顶部