文档中心 > API类目 > 小活动开放API

taobao.activity.item.risk.calc (商品资损信息预校验)

商品资损信息预校验

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
activity_start_time Number 必须 1699632000000 活动开始时间戳
activity_end_time Number 必须 1699732000000 活动结束时间戳
promotion_level Number 必须 1 优惠级别,1-商品级,3-sku级
item_risk_calc_req_v_o_list ItemDiscountVo 必须 校验的商品优惠信息
  • └ item_id
  • Number
  • 必须
  • 526160715680
  • 商品id
  • sku_list
  • SkuRiskCalcReqVo []
  • 必须
  • sku风险校验对象
  • └ sku_id
  • Number
  • 必须
  • 3
  • skuId
  • └ discount_display
  • Number
  • 必须
  • 800
  • 优惠值,减钱单位为分;打折为折数*100,例如8折为800
  • └ discount_type
  • Number
  • 必须
  • 1
  • 商品的优惠类型,促销价为1,打折为2,减钱为4
  • └ is_discard_fen
  • Boolean
  • 必须
  • true
  • 是否抹分,表示当前优惠商品的优惠价格是否做抹分操作
  • └ is_math_floor
  • Boolean
  • 必须
  • true
  • 是否取整,表示当前优惠商品的优惠价格是否做取整操作
  • └ discount_display
  • Number
  • 必须
  • 800
  • 优惠值,减钱单位为分;打折为折数*100,例如8折为800
  • └ discount_type
  • Number
  • 必须
  • 1
  • 商品的优惠类型,促销价为1,打折为2,减钱为4
  • └ is_discard_fen
  • Boolean
  • 必须
  • true
  • 是否抹分,表示当前优惠商品的优惠价格是否做抹分操作
  • └ is_math_floor
  • Boolean
  • 必须
  • true
  • 是否取整,表示当前优惠商品的优惠价格是否做取整操作
activity_source String 必须 SINGLE_TREASURE 活动类型

响应参数

名称 类型 示例值 描述
tao_activity_item_promotion_risk_calc_resp_list TaoActivityItemPromotionRiskCalcResp [] 响应结果
  • └ item_id
  • String
  • 581535339218
  • 商品id
  • sku_risk_calc_results
  • RiskCalcSkuVo []
  • sku资损信息
  • └ sku_id
  • String
  • 4053200027223
  • skuId
  • └ after_price
  • String
  • 4000.00
  • 计算后价格
  • └ discount_price
  • String
  • 1000.00
  • 优惠金额
  • └ has_risk
  • Boolean
  • false
  • 是否有风险
  • └ risk_key
  • String
  • xxxxx
  • 风险key
  • └ risk_level
  • Number
  • 10
  • 风险等级
  • └ risk_name
  • String
  • xxxxx
  • 风险名称
  • └ is_block
  • Boolean
  • false
  • 是否阻断提交
  • └ after_price
  • String
  • 4000.00
  • 计算后价格
  • └ discount_price
  • String
  • 1000.00
  • 优惠金额
  • └ has_risk
  • Boolean
  • false
  • 是否有风险
  • └ risk_key
  • String
  • xxxxx
  • 风险key
  • └ risk_level
  • Number
  • 10
  • 风险等级
  • └ risk_name
  • String
  • xxxxx
  • 风险名称
  • └ is_block
  • Boolean
  • false
  • 是否阻断提交

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ActivityItemRiskCalcRequest req = new ActivityItemRiskCalcRequest();
req.setActivityStartTime(1699632000000L);
req.setActivityEndTime(1699732000000L);
req.setPromotionLevel(1L);
ActivityItemRiskCalcRequest.ItemDiscountVo obj1 = new ActivityItemRiskCalcRequest.ItemDiscountVo();
obj1.setItemId(526160715680L);
List<ActivityItemRiskCalcRequest.SkuRiskCalcReqVo> list3 = new ArrayList<ActivityItemRiskCalcRequest.SkuRiskCalcReqVo>();
ActivityItemRiskCalcRequest.SkuRiskCalcReqVo obj4 = new ActivityItemRiskCalcRequest.SkuRiskCalcReqVo();
list3.add(obj4);
obj4.setSkuId(3L);
obj4.setDiscountDisplay(800L);
obj4.setDiscountType(1L);
obj4.setIsDiscardFen(true);
obj4.setIsMathFloor(true);
obj1.setSkuList(list3);
obj1.setDiscountDisplay(800L);
obj1.setDiscountType(1L);
obj1.setIsDiscardFen(true);
obj1.setIsMathFloor(true);
req.setItemRiskCalcReqVOList(obj1);
req.setActivitySource("SINGLE_TREASURE");
ActivityItemRiskCalcResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<activity_item_risk_calc_response>
    <tao_activity_item_promotion_risk_calc_resp_list>
        <tao_activity_item_promotion_risk_calc_resp>
            <item_id>581535339218</item_id>
            <sku_risk_calc_results>
                <risk_calc_sku_vo>
                    <sku_id>4053200027223</sku_id>
                    <after_price>4000.00</after_price>
                    <discount_price>1000.00</discount_price>
                    <has_risk>false</has_risk>
                    <risk_key>xxxxx</risk_key>
                    <risk_level>10</risk_level>
                    <risk_name>xxxxx</risk_name>
                    <is_block>false</is_block>
                </risk_calc_sku_vo>
            </sku_risk_calc_results>
            <after_price>4000.00</after_price>
            <discount_price>1000.00</discount_price>
            <has_risk>false</has_risk>
            <risk_key>xxxxx</risk_key>
            <risk_level>10</risk_level>
            <risk_name>xxxxx</risk_name>
            <is_block>false</is_block>
        </tao_activity_item_promotion_risk_calc_resp>
    </tao_activity_item_promotion_risk_calc_resp_list>
</activity_item_risk_calc_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

返回
顶部