taobao.fenxiao.discounts.get (获取折扣信息)

查询折扣信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
discount_id Number 可选 123 折扣ID
ext_fields String 可选 DETAIL 指定查询额外的信息,可选值:DETAIL(查询折扣详情),多个可选值用逗号分割。(只允许指定折扣ID情况下使用)

响应参数

名称 类型 示例值 描述
total_results Number 12 记录数
discounts Discount [] 折扣数据结构
  • └ discount_id
  • Number
  • 123
  • 折扣ID
  • └ name
  • String
  • 一级会员
  • 折扣名称
  • details
  • DiscountDetail []
  • 折扣详情
  • └ detail_id
  • Number
  • 456
  • 折扣详情ID
  • └ target_type
  • String
  • GRADE
  • 折扣类型:GRADE(按会员等级优惠)、DISTRIBUTOR(按分销商优惠)
  • └ target_id
  • Number
  • 789
  • 会员等级的id或者分销商id
  • └ target_name
  • String
  • 一级会员
  • 等级名称或者分销商名称
  • └ discount_type
  • String
  • PERCENT
  • 优惠方式:PERCENT(按折扣优惠)、PRICE(按减价优惠)
  • └ discount_value
  • Number
  • 10
  • 优惠比率或者优惠价格 10%或10
  • └ created
  • Date
  • 2000-01-01 00:00:00
  • 创建时间
  • └ modified
  • Date
  • 2000-01-01 00:00:00
  • 修改时间
  • └ created
  • Date
  • 2000-01-01 00:00:00
  • 创建时间
  • └ modified
  • Date
  • 2000-01-01 00:00:00
  • 修改时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoDiscountsGetRequest req = new FenxiaoDiscountsGetRequest();
req.setDiscountId(123L);
req.setExtFields("DETAIL");
FenxiaoDiscountsGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<fenxiao_discounts_get_response>
    <total_results>12</total_results>
    <discounts>
        <discount>
            <discount_id>123</discount_id>
            <name>一级会员</name>
            <details>
                <discount_detail>
                    <detail_id>456</detail_id>
                    <target_type>GRADE</target_type>
                    <target_id>789</target_id>
                    <target_name>一级会员</target_name>
                    <discount_type>PERCENT</discount_type>
                    <discount_value>10</discount_value>
                    <created>2000-01-01 00:00:00</created>
                    <modified>2000-01-01 00:00:00</modified>
                </discount_detail>
            </details>
            <created>2000-01-01 00:00:00</created>
            <modified>2000-01-01 00:00:00</modified>
        </discount>
    </discounts>
</fenxiao_discounts_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

返回
顶部