alibaba.damai.maizuo.openapi.eticket.qrcode (票凭证API)

获取取票凭证(二维码、换票码、身份证取票等)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
dynamic_q_r_code_param DynamicQrCodeParam 必须 票凭证参数对象
  • └ order_id
  • String
  • 可选
  • 1000101121
  • 订单ID
  • └ user_id
  • Number
  • 可选
  • 200121001
  • 会员ID
  • └ event_id
  • String
  • 必须
  • 731021112
  • 场次ID
  • └ ticket_code_id
  • String
  • 必须
  • 4111231001
  • 票ID;从订单详情api获取
  • └ lang_type
  • Number
  • 可选
  • 1
  • 语言类型:1=中文,2=英文
  • └ tenant_token
  • String
  • 必须
  • AxcXYJ72Idfk1231+mCzqSXZLWtCnikX/VnjI=
  • 向api服务提供商获取
  • └ ptnr_token
  • String
  • 必须
  • 8SWB5xLq54Tn623qFzG+2u39r5xP5icqyWfwZ0zA=
  • 向api服务提供商获取
  • └ channel_token
  • String
  • 必须
  • xCv1KtwpNaDzuE459yus3m6F7FEG+2u39r5xP5icqyWfwZ0zA
  • 渠道签名,向api服务提供商获取
  • └ user_token
  • String
  • 可选
  • St5dnxCv1KtwpNaDzuE459yus3m6F7FEG+2u39r5xP5icqyWfwZ0zA=
  • 用户登录标识

响应参数

名称 类型 示例值 描述
result_data ResultData 统一返回值对象
  • └ success
  • Boolean
  • false
  • 是否成功
  • └ result_code
  • Number
  • 10
  • 状态码
  • └ result_msg
  • String
  • 成功
  • 提示信息
  • dynamic_q_r_code_vo
  • DynamicQrCodeVo
  • 返回数据
  • └ dynamic_q_r_code
  • String
  • 32A1xcXYJ72Idfk1231+mCzqSXZLWtCnikX/VnjI=
  • 动态二维码;一票一码;
  • └ qr_code_type
  • Number
  • 1
  • 票类型:1=静态,2=动态,3=换票码,4=身份证电子票
  • └ ticket_validate_state_desc
  • String
  • 未使用
  • 验票状态:1=未使用、2=已验票、3=已换票、4=已退票,5=已作废,6=无效票
  • └ ticket_validate_state
  • Number
  • 1
  • 验票状态:1=未使用、2=已验票、3=已换票、4=已退票,5=已作废,6=无效票
  • └ exchange_password
  • String
  • 3121131111
  • 换票码;一单一码
  • └ exchange_qrcode
  • String
  • 32A1xcXYJ72Idfk1231+mCzqSXZLWtCnikX/VnjI=
  • 静态取票二维码;一票一码;
  • └ is_no_paper
  • Number
  • 1
  • 是否开启无纸化入场;1=开启、2=未开启;无纸化开启可直接凭二维码验票入场,可不换取纸质票
  • └ receive_identity_code
  • String
  • 1xxxxxxxxx2
  • 取票人证件号码;qrCodeType=4时非空;已做脱敏处理,保留前1后1位;
  • └ receive_card_type
  • Number
  • 1
  • 取票人证件类型;目前只支持身份证号类型;1=身份证;qrCodeType=4时非空;
  • └ receive_name
  • String
  • 李xx
  • 取票人真实姓名;qrCodeType=4时非空;

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMaizuoOpenapiEticketQrcodeRequest req = new AlibabaDamaiMaizuoOpenapiEticketQrcodeRequest();
AlibabaDamaiMaizuoOpenapiEticketQrcodeRequest.DynamicQrCodeParam obj1 = new AlibabaDamaiMaizuoOpenapiEticketQrcodeRequest.DynamicQrCodeParam();
obj1.setOrderId("1000101121");
obj1.setUserId(200121001L);
obj1.setEventId("731021112");
obj1.setTicketCodeId("4111231001");
obj1.setLangType(1L);
obj1.setTenantToken("AxcXYJ72Idfk1231+mCzqSXZLWtCnikX/VnjI=");
obj1.setPtnrToken("8SWB5xLq54Tn623qFzG+2u39r5xP5icqyWfwZ0zA=");
obj1.setChannelToken("xCv1KtwpNaDzuE459yus3m6F7FEG+2u39r5xP5icqyWfwZ0zA");
obj1.setUserToken("St5dnxCv1KtwpNaDzuE459yus3m6F7FEG+2u39r5xP5icqyWfwZ0zA=");
req.setDynamicQRCodeParam(obj1);
AlibabaDamaiMaizuoOpenapiEticketQrcodeResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_maizuo_openapi_eticket_qrcode_response>
    <result_data>
        <success>false</success>
        <result_code>10</result_code>
        <result_msg>成功</result_msg>
        <dynamic_q_r_code_vo>
            <dynamic_q_r_code>32A1xcXYJ72Idfk1231+mCzqSXZLWtCnikX/VnjI=</dynamic_q_r_code>
            <qr_code_type>1</qr_code_type>
            <ticket_validate_state_desc>未使用</ticket_validate_state_desc>
            <ticket_validate_state>1</ticket_validate_state>
            <exchange_password>3121131111</exchange_password>
            <exchange_qrcode>32A1xcXYJ72Idfk1231+mCzqSXZLWtCnikX/VnjI=</exchange_qrcode>
            <is_no_paper>1</is_no_paper>
            <receive_identity_code>1xxxxxxxxx2</receive_identity_code>
            <receive_card_type>1</receive_card_type>
            <receive_name>李xx</receive_name>
        </dynamic_q_r_code_vo>
    </result_data>
</alibaba_damai_maizuo_openapi_eticket_qrcode_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

返回
顶部