淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
out_order_id	Number	可选	19247969900767149		外部订单号

名称	类型	示例值	描述
ins_orders	InsOrderOpenDTO []		保险订单
└ seller_nick String null 卖家昵称 └ gmt_modified Date null 修改时间 ins_order_detail_list InsOrderOpenDetailDTO [] 订单详情列表 └ ins_person_id Number null 被保人id └ gmt_modified Date null 修改时间 └ pay_time Date null 支付时间 └ tc_order_id Number null 保险订单号 ins_order_open_person InsOrderOpenPersonDTO 被保人信息 └ tc_order_id Number null 保险订单号 └ id_card_no String null idCardNo(md5脱敏) └ policy_no String null 子保单号 └ id_card_type Number null idCardType └ out_order_id Number null 外部订单号 └ policy_no String null 子保单号 └ is_enable Boolean null 订单是否有效 └ price Number null 保险价格 └ claim_apply_time Date null claimApplyTime └ product_no String null 保险产品编号 └ item_source_tag Number null itemSourceTag └ claim_fee Number null claimFee └ ins_company String null 保司名称 └ claim_success_time Date null claimSuccessTime └ effective_end_time Date null effectiveEndTime └ ins_segment_id Number null insSegmentId └ gmt_create Date null 创建时间 ins_order_open_segment InsOrderOpenSegmentDTO 航段信息 └ tc_order_id Number null 保险订单号 └ company_name String null 航司名称 └ arr_city String null 到达城市 └ dep_city String null 出发城市 └ policy_no String null 子保单号 └ segment_no String null 航段编号 └ out_order_id Number null 外部订单号 └ start_time Date null 出发时间 └ end_time Date null 到达时间 └ attribute String null attribute └ effective_start_time Date null effectiveStartTime └ out_order_id Number null 外部订单号 └ status Number null 子保单状态 └ tc_order_id Number null 保险订单号 └ policy_detail_url String null 保单详情页地址 └ policy_no String null 保单号 └ gmt_create Date null 创建时间 └ product_name String null 保险产品名称 └ features String null features └ seller_id Number null 保险供应方id └ copies Number null 保险份数 └ price Number null 保险价格 └ out_order_id Number null 外部订单号 └ product_no String null 保险产品编号 └ status Number null 保险订单状态 └ premium_id Number null 保险产品id
err_msg_for_client	String	null	错误信息，调用成功是该字段为空
is_success	Boolean	true	是否调用成功

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFlightInsuranceOrderSearchRequest req = new AlitripFlightInsuranceOrderSearchRequest();
req.setOutOrderId(19247969900767149L);
AlitripFlightInsuranceOrderSearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

<alitrip_flight_insurance_order_search_response>
    <ins_orders>
        <ins_order_open_d_t_o>
            <seller_nick>null</seller_nick>
            <gmt_modified>null</gmt_modified>
            <ins_order_detail_list>
                <ins_order_open_detail_d_t_o>
                    <ins_person_id>null</ins_person_id>
                    <gmt_modified>null</gmt_modified>
                    <pay_time>null</pay_time>
                    <tc_order_id>null</tc_order_id>
                    <ins_order_open_person>
                        <tc_order_id>null</tc_order_id>
                        <id_card_no>null</id_card_no>
                        <policy_no>null</policy_no>
                        <id_card_type>null</id_card_type>
                        <out_order_id>null</out_order_id>
                    </ins_order_open_person>
                    <policy_no>null</policy_no>
                    <is_enable>null</is_enable>
                    <price>null</price>
                    <claim_apply_time>null</claim_apply_time>
                    <product_no>null</product_no>
                    <item_source_tag>null</item_source_tag>
                    <claim_fee>null</claim_fee>
                    <ins_company>null</ins_company>
                    <claim_success_time>null</claim_success_time>
                    <effective_end_time>null</effective_end_time>
                    <ins_segment_id>null</ins_segment_id>
                    <gmt_create>null</gmt_create>
                    <ins_order_open_segment>
                        <tc_order_id>null</tc_order_id>
                        <company_name>null</company_name>
                        <arr_city>null</arr_city>
                        <dep_city>null</dep_city>
                        <policy_no>null</policy_no>
                        <segment_no>null</segment_no>
                        <out_order_id>null</out_order_id>
                        <start_time>null</start_time>
                        <end_time>null</end_time>
                        <attribute>null</attribute>
                    </ins_order_open_segment>
                    <effective_start_time>null</effective_start_time>
                    <out_order_id>null</out_order_id>
                    <status>null</status>
                </ins_order_open_detail_d_t_o>
            </ins_order_detail_list>
            <tc_order_id>null</tc_order_id>
            <policy_detail_url>null</policy_detail_url>
            <policy_no>null</policy_no>
            <gmt_create>null</gmt_create>
            <product_name>null</product_name>
            <features>null</features>
            <seller_id>null</seller_id>
            <copies>null</copies>
            <price>null</price>
            <out_order_id>null</out_order_id>
            <product_no>null</product_no>
            <status>null</status>
            <premium_id>null</premium_id>
        </ins_order_open_d_t_o>
    </ins_orders>
    <err_msg_for_client>null</err_msg_for_client>
    <is_success>true</is_success>
</alitrip_flight_insurance_order_search_response>

{
    "alitrip_flight_insurance_order_search_response":{
        "ins_orders":{
            "ins_order_open_d_t_o":[
                {
                    "seller_nick":"null",
                    "gmt_modified":"null",
                    "ins_order_detail_list":{
                        "ins_order_open_detail_d_t_o":[
                            {
                                "ins_person_id":null,
                                "gmt_modified":"null",
                                "pay_time":"null",
                                "tc_order_id":null,
                                "ins_order_open_person":{
                                    "tc_order_id":null,
                                    "id_card_no":"null",
                                    "policy_no":"null",
                                    "id_card_type":null,
                                    "out_order_id":null
                                },
                                "policy_no":"null",
                                "is_enable":null,
                                "price":null,
                                "claim_apply_time":"null",
                                "product_no":"null",
                                "item_source_tag":null,
                                "claim_fee":null,
                                "ins_company":"null",
                                "claim_success_time":"null",
                                "effective_end_time":"null",
                                "ins_segment_id":null,
                                "gmt_create":"null",
                                "ins_order_open_segment":{
                                    "tc_order_id":null,
                                    "company_name":"null",
                                    "arr_city":"null",
                                    "dep_city":"null",
                                    "policy_no":"null",
                                    "segment_no":"null",
                                    "out_order_id":null,
                                    "start_time":"null",
                                    "end_time":"null",
                                    "attribute":"null"
                                },
                                "effective_start_time":"null",
                                "out_order_id":null,
                                "status":null
                            }
                        ]
                    },
                    "tc_order_id":null,
                    "policy_detail_url":"null",
                    "policy_no":"null",
                    "gmt_create":"null",
                    "product_name":"null",
                    "features":"null",
                    "seller_id":null,
                    "copies":null,
                    "price":null,
                    "out_order_id":null,
                    "product_no":"null",
                    "status":null,
                    "premium_id":null
                }
            ]
        },
        "err_msg_for_client":"null",
        "is_success":true
    }
}

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测试工具错误码查询工具 SDK下载

开放平台

飞猪机票前台类目

alitrip.flight.insurance.order.search (查询保险订单详情)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ