文档中心 > API类目 > 电影票API

taobao.film.lottery.performance (淘票票履约发放权益)

对外第三方合作渠道通过抽奖形式发放权益

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
lottery_performance_top_param LotteryPerformanceTopParam 必须 入参
  • └ mix_user_id
  • String
  • 必须
  • AAHiqNnmACSqk_jfpVAMNjel
  • 用户对外开放ID
  • └ spread_id
  • String
  • 必须
  • prizePool_f1p2ruj1kuskz89x7udd4d7t2ntwutt4yttml
  • 活动ID
  • └ out_biz_id
  • String
  • 必须
  • test_out_biz_id
  • 幂等ID
  • └ platform
  • Number
  • 必须
  • 8
  • 平台(固定值8)
  • └ biz_ext_info
  • String
  • 可选
  • 业务拓展参数

响应参数

名称 类型 示例值 描述
return_code String 200005 错误码
return_value LotteryPerformanceResult 返回值
  • └ result_code
  • Number
  • 1
  • 结果状态码(1:全部成功;2:全部失败(建议重试或人工介入处理);3:部分成功需要重试;4:部分成功无需重试(需人工介入处理))
  • rewards
  • LotteryPerformanceRewardDTO []
  • 奖品列表
  • └ reward_title
  • String
  • 淘票票5元代金券/60元通兑券
  • 奖品主标题
  • └ reward_sub_title
  • String
  • 尊享电影+演出共10余项权益
  • 奖品副标题
  • └ reward_type
  • Number
  • 14
  • 奖品类型(1:淘票票优惠券;2:大麦优惠券;14:会员权益)
  • └ reward_sub_type
  • Number
  • 7
  • 优惠券子类型(1:兑换券 2:代金券)会员权益子类型(5:会员积分;7:普通会员;8:黑钻会员)
  • └ reward_count
  • Number
  • 50
  • 奖品数量
  • └ reward_unit
  • String
  • 奖品单位
  • └ cost_price
  • Number
  • 100
  • 奖品面额(单位分)
  • └ gmt_expire
  • String
  • 2022-06-08 13:33:00
  • 奖品过期时间(格式: yyyy-MM-dd HH:mm:ss)
  • └ reward_ext
  • String
  • {}
  • 拓展参数
return_error_stack_trace String 系统异常 returnErrorStackTrace
return_message String 活动已结束 错误描述
return_error_oper String taobao returnErrorOper
return_error_solution String 请重试 returnErrorSolution

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmLotteryPerformanceRequest req = new FilmLotteryPerformanceRequest();
FilmLotteryPerformanceRequest.LotteryPerformanceTopParam obj1 = new FilmLotteryPerformanceRequest.LotteryPerformanceTopParam();
obj1.setMixUserId("AAHiqNnmACSqk_jfpVAMNjel");
obj1.setSpreadId("prizePool_f1p2ruj1kuskz89x7udd4d7t2ntwutt4yttml");
obj1.setOutBizId("test_out_biz_id");
obj1.setPlatform(8L);
obj1.setBizExtInfo("");
req.setLotteryPerformanceTopParam(obj1);
FilmLotteryPerformanceResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_lottery_performance_response>
    <return_code>200005</return_code>
    <return_value>
        <result_code>1</result_code>
        <rewards>
            <lottery_performance_reward_d_t_o>
                <reward_title>淘票票5元代金券/60元通兑券</reward_title>
                <reward_sub_title>尊享电影+演出共10余项权益</reward_sub_title>
                <reward_type>14</reward_type>
                <reward_sub_type>7</reward_sub_type>
                <reward_count>50</reward_count>
                <reward_unit>元</reward_unit>
                <cost_price>100</cost_price>
                <gmt_expire>2022-06-08 13:33:00</gmt_expire>
                <reward_ext>{}</reward_ext>
            </lottery_performance_reward_d_t_o>
        </rewards>
    </return_value>
    <return_error_stack_trace>系统异常</return_error_stack_trace>
    <return_message>活动已结束</return_message>
    <return_error_oper>taobao</return_error_oper>
    <return_error_solution>请重试</return_error_solution>
</film_lottery_performance_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>

错误码解释

错误码 错误描述 解决方案
1005 参数不合法 活动ID、用户ID、幂等ID不能为空
200005 活动已结束 联系运营同学,检查活动配置
70005 用户没有通过资格校验 用户身份校验不通过,可能为黄牛等
200004 活动暂未开始 联系运营同学,检查活动配置
200008 预算已用完 联系运营同学,检查活动配置
200025 活动配置错误(错误原因XXX) 联系运营同学,检查活动配置
0 成功 无需

API工具

如何获得此API

FAQ

返回
顶部