文档中心 > API类目 > 汽车票API

taobao.alitrip.bus.tickets.insurance.recommend (汽车票保险推荐)

获取推荐保险内容

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
recommend_req TopStandardInsRecommendRequest 必须 请求对象
  • station_info
  • TopInsStationInfo
  • 可选
  • 站点信息对象
  • └ machine_id
  • String
  • 可选
  • 1111
  • 机具ID
  • └ city_code
  • String
  • 可选
  • 10000
  • 城市代码,数据源来自行业基础数据字典
  • └ isv_name
  • String
  • 可选
  • XXX
  • isv名称
  • └ isv_id
  • String
  • 可选
  • 1111
  • isv-id
  • └ province_code
  • String
  • 可选
  • 10001
  • 省份代码,数据源来自行业基础数据字典
  • └ start_station_id
  • String
  • 可选
  • 1111
  • 出发车站站点ID
  • └ target_channel
  • String
  • 必须
  • OFF_LINE
  • OFF_LINE(线下自助机)、OTA(OTA)、SUBMIT_ORDER_PAGE(下单页)、RECOMMEND_PAGE (推荐弹层)、STORE_WINDOW(商家窗口)。目前仅开放了线下自助机和商家窗口。
  • merchant_info
  • TopInsMerchantInfo
  • 可选
  • 商户身份对象
  • └ merchant_id
  • String
  • 可选
  • 111
  • 商户ID
  • └ merchant_name
  • String
  • 可选
  • XXX
  • 商户名称
  • commodity_info
  • TopInsCommodityInfo
  • 可选
  • 商品信息对象
  • └ ticket_price
  • Number
  • 可选
  • 100
  • 票价,单位:分
  • └ travel_date
  • String
  • 可选
  • 202010221030
  • 出行日期,精确到分钟 yyyyMMddHHmm
  • └ start_station_id
  • String
  • 可选
  • XXXX
  • 起始站点
  • └ itinerary_time
  • Number
  • 可选
  • 100
  • 行程时长,精确到分钟

响应参数

名称 类型 示例值 描述
result Result 接口返回结果数据
  • └ success
  • Boolean
  • true
  • 是否成功
  • response
  • TopStandardInsRecommendResponse
  • 接口返回结果对象
  • result_list
  • TopInsProduct []
  • 推荐结果
  • └ ins_title
  • String
  • 保险模块标题
  • 保险模块标题
  • └ ins_name
  • String
  • 众安汽车乘意险
  • 保险名称
  • └ ins_price
  • Number
  • 2000
  • 保险金额
  • └ interest_info
  • String
  • 保险利益点信息
  • 保险利益点信息
  • └ pro_code
  • String
  • 002005****1000073182
  • 保险产品码
  • └ resource_map
  • String
  • {"claimServicePhone":{"name":"理赔服务电话","type":"text","value":"10109955","key":"claimServicePhone"},"productImage":{"type":"oss_url","value":"https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53127259964565794/头图.jpg","key":"productImage"},"insMustKnow":{"name":"投保须知","type":"file","value":"https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53307960881829822/投保须知.pdf","key":"insMustKnow"},"customerServicePhone":{"name":"客服电话","type":"text","value":"10109955","key":"customerServicePhone"},"specialTermsAndConditions":{"name":"特别约定","type":"text","value":"1.本保险产品的交通工具仅指经相关政府部门登记许可的以客运为目的的汽车。 2.本保险产品的承保区域为中华人民共和国境内(不包括香港、澳门及台湾地区)。 3.保险期间:在保险期限内,被保险人持有效客票乘坐购买本保险产品时所对应车票订单中约定的合法经营客运业务的境内(不含港澳台)汽车,自被保险人持有效车票上车时起,至被保险人到达车票载明或约定的旅程终点下车时终止。本保险产品的意外伤害事故须发生在汽车车厢内,若在汽车车厢外发生的保险事故,保险人不承担赔偿责任。 4.本保险产品必需且合理的医疗费用,应是符合当地社会基本医疗保险报销范围内的费用,且治疗医院范围为当地医保定点二级(含)以上的公立医院,不包括北京市平谷区、密云县、怀柔区的所有医疗机构、四川省宜宾市的所有医疗机构、四川省雅安市雨城区人民医院与四川省雅安市第二人民医院与山东省栖霞市的所有医疗机构。","key":"specialTermsAndConditions"},"productFeatureImage":{"name":"产品特色图片","type":"oss_url","value":"[\"https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53127151653899377/详情页1.jpg\",\"https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53127239245352247/详情页2.jpg\",\"https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53127244212419242/详情页3.jpg\"]","key":"productFeatureImage"},"checkDtails":{"name":"查看详情","type":"file","value":"https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53129211728310009/查看详情.pdf","key":"checkDtails"},"claimFlow":{"name":"理赔流程","type":"file","value":"https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53307954353408205/理赔说明-线下版.pdf","key":"claimFlow"},"productTerm":{"name":"保险条款","type":"file","value":"https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53129079606962062/合并版条款.pdf","key":"productTerm"},"prodTag":{"name":"产品标签","value":"汽车意外保障 | 意外医疗0免赔","key":"prodTag"},"productFeature":{"name":"产品特色","type":"text","value":"[\"最低3元起,享15万意外保障\",\"所乘车次中意外烫伤、磕碰均保\"]","key":"productFeature"}}
  • 资源项,图文信息等
  • └ biz_ext_map
  • String
  • XXX
  • 扩展预留
  • └ msg_info
  • String
  • 1
  • msgInfo
  • └ msg_code
  • String
  • 1
  • msgCode

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBusTicketsInsuranceRecommendRequest req = new AlitripBusTicketsInsuranceRecommendRequest();
AlitripBusTicketsInsuranceRecommendRequest.TopStandardInsRecommendRequest obj1 = new AlitripBusTicketsInsuranceRecommendRequest.TopStandardInsRecommendRequest();
AlitripBusTicketsInsuranceRecommendRequest.TopInsStationInfo obj2 = new AlitripBusTicketsInsuranceRecommendRequest.TopInsStationInfo();
obj2.setMachineId("1111");
obj2.setCityCode("10000");
obj2.setIsvName("XXX");
obj2.setIsvId("1111");
obj2.setProvinceCode("10001");
obj2.setStartStationId("1111");
obj1.setStationInfo(obj2);
obj1.setTargetChannel("OFF_LINE");
AlitripBusTicketsInsuranceRecommendRequest.TopInsMerchantInfo obj3 = new AlitripBusTicketsInsuranceRecommendRequest.TopInsMerchantInfo();
obj3.setMerchantId("111");
obj3.setMerchantName("XXX");
obj1.setMerchantInfo(obj3);
AlitripBusTicketsInsuranceRecommendRequest.TopInsCommodityInfo obj4 = new AlitripBusTicketsInsuranceRecommendRequest.TopInsCommodityInfo();
obj4.setTicketPrice(100L);
obj4.setTravelDate("202010221030");
obj4.setStartStationId("XXXX");
obj4.setItineraryTime(100L);
obj1.setCommodityInfo(obj4);
req.setRecommendReq(obj1);
AlitripBusTicketsInsuranceRecommendResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_bus_tickets_insurance_recommend_response>
    <result>
        <success>true</success>
        <response>
            <result_list>
                <top_ins_product>
                    <ins_title>保险模块标题</ins_title>
                    <ins_name>众安汽车乘意险</ins_name>
                    <ins_price>2000</ins_price>
                    <interest_info>保险利益点信息</interest_info>
                    <pro_code>002005****1000073182</pro_code>
                    <resource_map>{&quot;claimServicePhone&quot;:{&quot;name&quot;:&quot;理赔服务电话&quot;,&quot;type&quot;:&quot;text&quot;,&quot;value&quot;:&quot;10109955&quot;,&quot;key&quot;:&quot;claimServicePhone&quot;},&quot;productImage&quot;:{&quot;type&quot;:&quot;oss_url&quot;,&quot;value&quot;:&quot;https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53127259964565794/头图.jpg&quot;,&quot;key&quot;:&quot;productImage&quot;},&quot;insMustKnow&quot;:{&quot;name&quot;:&quot;投保须知&quot;,&quot;type&quot;:&quot;file&quot;,&quot;value&quot;:&quot;https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53307960881829822/投保须知.pdf&quot;,&quot;key&quot;:&quot;insMustKnow&quot;},&quot;customerServicePhone&quot;:{&quot;name&quot;:&quot;客服电话&quot;,&quot;type&quot;:&quot;text&quot;,&quot;value&quot;:&quot;10109955&quot;,&quot;key&quot;:&quot;customerServicePhone&quot;},&quot;specialTermsAndConditions&quot;:{&quot;name&quot;:&quot;特别约定&quot;,&quot;type&quot;:&quot;text&quot;,&quot;value&quot;:&quot;1.本保险产品的交通工具仅指经相关政府部门登记许可的以客运为目的的汽车。 2.本保险产品的承保区域为中华人民共和国境内(不包括香港、澳门及台湾地区)。 3.保险期间:在保险期限内,被保险人持有效客票乘坐购买本保险产品时所对应车票订单中约定的合法经营客运业务的境内(不含港澳台)汽车,自被保险人持有效车票上车时起,至被保险人到达车票载明或约定的旅程终点下车时终止。本保险产品的意外伤害事故须发生在汽车车厢内,若在汽车车厢外发生的保险事故,保险人不承担赔偿责任。 4.本保险产品必需且合理的医疗费用,应是符合当地社会基本医疗保险报销范围内的费用,且治疗医院范围为当地医保定点二级(含)以上的公立医院,不包括北京市平谷区、密云县、怀柔区的所有医疗机构、四川省宜宾市的所有医疗机构、四川省雅安市雨城区人民医院与四川省雅安市第二人民医院与山东省栖霞市的所有医疗机构。&quot;,&quot;key&quot;:&quot;specialTermsAndConditions&quot;},&quot;productFeatureImage&quot;:{&quot;name&quot;:&quot;产品特色图片&quot;,&quot;type&quot;:&quot;oss_url&quot;,&quot;value&quot;:&quot;[\&quot;https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53127151653899377/详情页1.jpg\&quot;,\&quot;https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53127239245352247/详情页2.jpg\&quot;,\&quot;https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53127244212419242/详情页3.jpg\&quot;]&quot;,&quot;key&quot;:&quot;productFeatureImage&quot;},&quot;checkDtails&quot;:{&quot;name&quot;:&quot;查看详情&quot;,&quot;type&quot;:&quot;file&quot;,&quot;value&quot;:&quot;https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53129211728310009/查看详情.pdf&quot;,&quot;key&quot;:&quot;checkDtails&quot;},&quot;claimFlow&quot;:{&quot;name&quot;:&quot;理赔流程&quot;,&quot;type&quot;:&quot;file&quot;,&quot;value&quot;:&quot;https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53307954353408205/理赔说明-线下版.pdf&quot;,&quot;key&quot;:&quot;claimFlow&quot;},&quot;productTerm&quot;:{&quot;name&quot;:&quot;保险条款&quot;,&quot;type&quot;:&quot;file&quot;,&quot;value&quot;:&quot;https://bxcloudstore.alicdn.com/insmerchantprod/ZAOL/53129079606962062/合并版条款.pdf&quot;,&quot;key&quot;:&quot;productTerm&quot;},&quot;prodTag&quot;:{&quot;name&quot;:&quot;产品标签&quot;,&quot;value&quot;:&quot;汽车意外保障 | 意外医疗0免赔&quot;,&quot;key&quot;:&quot;prodTag&quot;},&quot;productFeature&quot;:{&quot;name&quot;:&quot;产品特色&quot;,&quot;type&quot;:&quot;text&quot;,&quot;value&quot;:&quot;[\&quot;最低3元起,享15万意外保障\&quot;,\&quot;所乘车次中意外烫伤、磕碰均保\&quot;]&quot;,&quot;key&quot;:&quot;productFeature&quot;}}</resource_map>
                </top_ins_product>
            </result_list>
        </response>
        <biz_ext_map>XXX</biz_ext_map>
        <msg_info>1</msg_info>
        <msg_code>1</msg_code>
    </result>
</alitrip_bus_tickets_insurance_recommend_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

返回
顶部