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

taobao.film.lottery.sendcode (淘票票外部直发券)

淘票票外部直发券

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_f_code_merchant_send_code_request FCodeMerchantSendCodeRq 可选 外部商户发码请求
  • └ out_uid
  • String
  • 可选
  • uid-333
  • 外部业务用户id
  • └ each_num
  • Number
  • 必须
  • 1
  • 每个用户发码的数量
  • └ mix_id
  • String
  • 必须
  • a09da62085f10074
  • 发券码商品mixId
  • └ ext_order_id
  • String
  • 必须
  • 123456789042
  • 外部商户发码的外部业务号
  • └ number
  • Number
  • 必须
  • 1
  • 发码总数
  • └ order_time
  • String
  • 可选
  • 2018-05-09 00:00:00
  • 外部下单时间
  • └ user_id_type
  • String
  • 可选
  • TAOBAO
  • 用户ID类型 TAOBAO 或者 TAOBAO_NAME
  • └ partner_code
  • String
  • 可选
  • tfxenia
  • 外部商户标示
  • └ out_user_name
  • String
  • 可选
  • usernamexxxxx
  • 外面用户昵称
  • └ feature
  • String
  • 可选
  • suesu
  • 请求属性字段
  • └ user_id_list
  • String
  • 可选
  • 3649052181
  • 淘宝用户ID列表,用|分割

响应参数

名称 类型 示例值 描述
result ResultGeneralModel result
  • └ return_url
  • String
  • returnUrl
  • └ return_code
  • String
  • 0
  • 服务返回出参
  • └ request_id
  • String
  • requestId
  • return_value
  • FCodeMerchantSendCodeRp
  • 返回具体结果
  • f_code_merchant_info_list
  • FCodeMerchantVo []
  • 码对外信息描述列表
  • └ gmt_expire
  • Date
  • 2018-06-09 08:07:48
  • 码过期时间
  • └ gen_task_id
  • Number
  • 123
  • 码生成任务ID
  • └ cost_price
  • Number
  • 123
  • 码可抵用金额
  • └ code
  • String
  • 123
  • code
  • └ return_error_oper
  • String
  • returnErrorOper
  • └ return_error_solution
  • String
  • returnErrorSolution
  • └ return_message
  • String
  • success
  • 调用信息
  • └ return_error_stack_trace
  • String
  • returnErrorStackTrace
  • └ success
  • Boolean
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmLotterySendcodeRequest req = new FilmLotterySendcodeRequest();
FilmLotterySendcodeRequest.FCodeMerchantSendCodeRq obj1 = new FilmLotterySendcodeRequest.FCodeMerchantSendCodeRq();
obj1.setOutUid("uid-333");
obj1.setEachNum(1L);
obj1.setMixId("a09da62085f10074");
obj1.setExtOrderId("123456789042");
obj1.setNumber(1L);
obj1.setOrderTime("2018-05-09 00:00:00");
obj1.setUserIdType("TAOBAO");
obj1.setPartnerCode("tfxenia");
obj1.setOutUserName("usernamexxxxx");
obj1.setFeature("suesu");
obj1.setUserIdList("3649052181");
req.setParamFCodeMerchantSendCodeRequest(obj1);
FilmLotterySendcodeResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<film_lottery_sendcode_response>
    <result>
        <return_url></return_url>
        <return_code>0</return_code>
        <request_id></request_id>
        <return_value>
            <f_code_merchant_info_list>
                <f_code_merchant_vo>
                    <gmt_expire>2018-06-09 08:07:48</gmt_expire>
                    <gen_task_id>123</gen_task_id>
                    <cost_price>123</cost_price>
                    <code>123</code>
                </f_code_merchant_vo>
            </f_code_merchant_info_list>
        </return_value>
        <return_error_oper></return_error_oper>
        <return_error_solution></return_error_solution>
        <return_message>success</return_message>
        <return_error_stack_trace></return_error_stack_trace>
        <success></success>
    </result>
</film_lottery_sendcode_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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

返回
顶部