文档中心 > API类目 > 闲鱼电商SAAS

alibaba.idle.game.promotion.query (游戏租号优惠查询)

按闲鱼来源商品和服务商动态价格,查询当前买家的投缘红包、优惠金额及预计支付金额

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
game_rental_promotion_top_request GameRentalPromotionTopRequest 必须 游戏租号优惠查询请求
  • └ item_id
  • Number
  • 必须
  • 123456789
  • 闲鱼来源商品ID,用于派生闲鱼卖家并校验商品与服务商应用关系
  • └ buy_num
  • Number
  • 可选
  • 1
  • 购买数量,不传默认为1
  • └ promotion_base_amount
  • Number
  • 必须
  • 1500
  • 服务商优惠后、闲鱼投缘红包扣减前的订单金额,单位分

响应参数

名称 类型 示例值 描述
result Result 统一接口响应
  • └ code
  • String
  • SUCCESS
  • 错误编码,成功时为 SUCCESS
  • data
  • GameRentalPromotionTopResponse
  • 游戏租号优惠查询结果
  • └ item_id
  • Number
  • 123456789
  • 闲鱼来源商品 ID
  • └ platform_discount_amount
  • Number
  • 300
  • 本次应用的单个闲鱼优惠金额,单位分
  • └ promotion_base_amount
  • Number
  • 1500
  • 服务商优惠后的营销基准金额,单位分,不包含投缘红包
  • └ payable_amount
  • Number
  • 1200
  • 预计支付金额,单位分
  • applied_promotion
  • GameRentalPromotionDTO
  • 按 discountType 过滤后优惠金额最大的一个优惠;无可用优惠时为空
  • └ description
  • String
  • 优惠券
  • 优惠利益点文案
  • └ discount_amount
  • Number
  • 300
  • 该优惠抵扣金额,单位分
  • └ id_value
  • String
  • promotion-id-value
  • 营销优惠标识;选择后须原样写入 gamePromotionInfo
  • └ type
  • String
  • destined_discount
  • 营销优惠类型,原样返回营销 discountType
  • └ title
  • String
  • 投缘优惠
  • 优惠标题
  • └ selected
  • Boolean
  • true
  • 是否为本次试算默认应用的优惠
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 系统错误,请稍后重试
  • 错误信息,成功时可为空

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleGamePromotionQueryRequest req = new AlibabaIdleGamePromotionQueryRequest();
AlibabaIdleGamePromotionQueryRequest.GameRentalPromotionTopRequest obj1 = new AlibabaIdleGamePromotionQueryRequest.GameRentalPromotionTopRequest();
obj1.setItemId(123456789L);
obj1.setBuyNum(1L);
obj1.setPromotionBaseAmount(1500L);
req.setGameRentalPromotionTopRequest(obj1);
AlibabaIdleGamePromotionQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_idle_game_promotion_query_response>
    <result>
        <code>SUCCESS</code>
        <data>
            <item_id>123456789</item_id>
            <platform_discount_amount>300</platform_discount_amount>
            <promotion_base_amount>1500</promotion_base_amount>
            <payable_amount>1200</payable_amount>
            <applied_promotion>
                <description>优惠券</description>
                <discount_amount>300</discount_amount>
                <id_value>promotion-id-value</id_value>
                <type>destined_discount</type>
                <title>投缘优惠</title>
                <selected>true</selected>
            </applied_promotion>
        </data>
        <success>true</success>
        <message>系统错误,请稍后重试</message>
    </result>
</alibaba_idle_game_promotion_query_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

返回
顶部