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

taobao.film.lottery.performance.invalid (淘票票履约权益作废)

三方渠道合作,权益发放后的作废接口,支持部分作废

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
performance_invalid_top_param PerformanceInvalidTopParam 必须 入参
  • └ out_biz_id
  • String
  • 必须
  • test_out_biz_id
  • 幂等ID
  • └ mix_user_id
  • String
  • 必须
  • AAHbqNnmACSqk_rfpVTc9e3T
  • 用户对外开放ID
  • └ biz_ext_info
  • String
  • 可选
  • {}
  • 业务拓展参数

响应参数

名称 类型 示例值 描述
return_value PerformanceInvalidResult 履约作废结果
  • └ invalid_codes
  • String []
  • 本次作废的券码
return_message String 成功 错误描述
return_code String 0 错误码,0表示成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmLotteryPerformanceInvalidRequest req = new FilmLotteryPerformanceInvalidRequest();
FilmLotteryPerformanceInvalidRequest.PerformanceInvalidTopParam obj1 = new FilmLotteryPerformanceInvalidRequest.PerformanceInvalidTopParam();
obj1.setOutBizId("test_out_biz_id");
obj1.setMixUserId("AAHbqNnmACSqk_rfpVTc9e3T");
obj1.setBizExtInfo("{}");
req.setPerformanceInvalidTopParam(obj1);
FilmLotteryPerformanceInvalidResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_lottery_performance_invalid_response>
    <return_value>
    </return_value>
    <return_message>成功</return_message>
    <return_code>0</return_code>
</film_lottery_performance_invalid_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 参数不合法 根据错误描述检查入参
1002 小二很忙,稍后再试吧 联系运营同学,反馈问题,提供调用时的入参
201072 无需作废, 无发放成功的奖品 检查发放权益时是否失败了,如果发成功了,请检查幂等ID是否与发放接口的一致。
201073 无法作废, 非券奖品不支持作废 该接口只能作废券,如果发放时包含非券奖品,则不支持作废。
201074 无法作废,不存在未使用状态的券 券已使用或已作废,可通过机器人查询券状态。该接口只能作废未使用的券。
201071 作废失败,请重试 重试无果,可联系运营同学,反馈问题,提供调用时的入参
0 成功 无需

API工具

如何获得此API

FAQ

返回
顶部