阿里安全开放平台-阿里聚安全

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
apply_id	String	可选	123		申请单号
domestic_intl	Number	可选	1		国际国内标识(1 国内,2 国际)

名称	类型	示例值	描述
result	ResultDto		异步获取历史数据接口返回结果
data RefundDetailDto 结果数据 └ apply_id String RdSDumQCBZ 申请单号 └ voluntary Number 1 自愿标识:0.非自愿，1.自愿 └ reason String 7VfozcVjFB 申请原因 └ agent_id Number 1180023 店铺id └ domestic_intl Number 1 国际国内标识(1国内,2国际) └ order_id String cNkiP9AqRb 关联飞猪订单号 refund_list RefundList [] 退票数据集 └ passenger_name String hbIqVfWk69 乘客姓名 └ refund_fee Number 2 退票费，单位:分 └ tickets String [] 票号 └ refund_upgrade_fee Number 99 升舱手续费，单位:分 └ refund_modify_fee Number 99 改期手续费，单位:分 refund_segments RefundSegments [] 退票航段 └ cabin_class String mXAMw2RecA 舱等 └ flight_no String mcmytpbwyy 航班号 └ dep_time Date 1609748813406 起飞时间 └ arr_city String PEFjkhEQJ9 到达城市 └ dep_city String reRqNB53Br 起飞城市 └ cabin String MQfSonazHQ 舱位 └ segment_index Number 37 航段序号 └ arr_airport String 24gsWJYBiB 到达机场 └ dep_airport String xs6q8sSSWk 起飞机场 └ arr_time Date 1609748813406 到达时间 └ od_index Number 65 航程序号 └ refund_amount Number 10000 退款金额，单位:分（出后退:退款金额=实收金额-退票费；改后退:退款金额=实收金额+总改期费+总升舱费-退票费-改签手续费-升舱手续费） └ ticket_price Number 10000 票面价，单位:分 └ passenger_type Number 1 乘客类型:1 成人 ,2 儿童,3 婴儿,4 留学生 taxes Tax [] 税费，单位:分 └ tax_code String CN 税费编码(CN:机场建设费 ,YQ 燃油附加税) └ amount Number 100 税费金额，单位:分 └ not_refund_amount Number 100 不可退税费，单位:分 └ total_modify_fee Number 100 升舱总费用，单位:分 └ total_upgrade_fee Number 100 改签总费用，单位:分 └ real_price Number 10000 实收金额：单位:分 └ refund_item_type Number 2 1:出后退,2:改后退 └ pnr_xe Number 0 0:没有xe，1:xe了 └ pnr_xe_time Date 1609748813397 xe时间 └ sur_name String ZHANG 姓氏 └ given_name String SAN 名字 └ cert_period String 2026-03-15 乘机人证件有效期 └ nationality String CN 乘机人国籍 └ cert_issue_country String CN 乘机人证件颁发国家 └ birthday String 1987-04-05 乘机人生日 └ gender Number 1 乘机人性别:1表示男性，2表示女性 └ sla String RMpK6hrrRj sla └ currency String H6hvhlDEcf 交易币种:CNY:人民币, USD:美元, HKD:港元 └ apply_time Date 1609748813397 申请时间 └ status Number 43 退票状态:待回填:1, 待退款:2, 退款中:3, 已完结:4, 已拒绝:5 └ refuse_reason String 拒绝拒绝原因 └ apply_reason_type Number 12 申请原因类型:0:其他, 1:航变,2:病退 ,3:疫情,4:特殊提退 └ supplement Number 1 补退单标识(1是补退单) └ tags String [] ["URGENT"] 紧急标识:EPIDEMIC:疫情审核通过标, REASSURING_TICKET:安心票, FLIGHTCHANGE:航变审核通过标, CALCULATED:预计算, FLIGHTCHANGECANCEL:航班取消, FLIGHTCHANGEDELAY:航班延误, ILLWITHCERTIFICATE:病退, REFUSETOTAKE:航司拒载, PREVIOUSLATTERINTERFERENCE:前后段影响, OVERBOOKING:超售, AIRLINEAUTHORIZE:航司授权, CHANGENAME:改名, REPEATBUYTICKETS:重复购票, BUYWRONGTICKETS:错购, AIRLINEVIPCARDREFUND:航司金银卡退票 └ refund_way_type Number 1 0:"原路退回",1:"退银行卡",2:"原路退回+退银行卡" └ attachment String [] xxx.xxx.xxx xxx.xxx.xxx └ trip_type Number 1 1:"单程", 2:"往返", 3:"多程" └ correlation_order_id String 1123123 关联单号 └ involuntary_pass_type Number 0 预审通过类型：0:航变预审通过;1:疫情预审通过;2:病退预审通过;3:航变预审通过(延误);4:航变预审通过(取消); 5:其他预审通过(拒载);6:其他预审通过(前后段影响);7:其他预审通过(超售);8:其他预审通过(航司授权); 9:其他预审通过(改名);10:其他预审通过(重复购票);11:其他预审通过(错购);12:其他预审通过(航司金银卡); 其他枚举值：预审通过 └ refund_service_type Number 1 服务类型 -1 未知 1 极速退款 2 限时免费退 3 极速退款;限时免费退 └ ful_fill_ment_deadline Date 2024-04-19 18:00:00 履约截止时效 └ fee_back_fill_deadline Date 2024-04-19 18:00:00 费用回填截止日期 └ order_item_type Number 2 订单类型 1: 机票 2：行李 └ emphasis_serve_tags String [] 重点服务标识：EMPHASIS_PASSENGER：重点保障客户 └ success Boolean true 执行结果 └ error_code String 000 错误码:000:系统异常, 001:请求参数不合法, 002:权限不足, 003:操作失败, 004:流量管控 └ error_msg String 异常信息错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripAgentFlightSellRefundDetailRequest req = new AlitripAgentFlightSellRefundDetailRequest();
req.setApplyId("123");
req.setDomesticIntl(1L);
AlitripAgentFlightSellRefundDetailResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripAgentFlightSellRefundDetailRequest req = new AlitripAgentFlightSellRefundDetailRequest();
req.ApplyId = "123";
req.DomesticIntl = 1L;
AlitripAgentFlightSellRefundDetailResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripAgentFlightSellRefundDetailRequest;
$req->setApplyId("123");
$req->setDomesticIntl("1");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alitrip.agent.flight.sell.refund.detail' \
-d 'partner_id=apidoc' \
-d 'session=fb3acc2a-6203-4c11-a421-f362c8906903' \
-d 'sign=227446A99F120031389FC46B13D30F00' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-16+11%3A06%3A33' \
-d 'v=2.0' \
-d 'apply_id=123' \
-d 'domestic_intl=1'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlitripAgentFlightSellRefundDetailRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.apply_id="123"
req.domestic_intl=1
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alitrip.agent.flight.sell.refund.detail");
add_param(pRequest,"apply_id","123");
add_param(pRequest,"domestic_intl","1");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alitrip.agent.flight.sell.refund.detail', {
	'apply_id':'123',
	'domestic_intl':'1'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_agent_flight_sell_refund_detail_response>
    <result>
        <data>
            <apply_id>RdSDumQCBZ</apply_id>
            <voluntary>1</voluntary>
            <reason>7VfozcVjFB</reason>
            <agent_id>1180023</agent_id>
            <domestic_intl>1</domestic_intl>
            <order_id>cNkiP9AqRb</order_id>
            <refund_list>
                <refund_list>
                    <passenger_name>hbIqVfWk69</passenger_name>
                    <refund_fee>2</refund_fee>
                    <tickets>
                        <string></string>
                    </tickets>
                    <refund_upgrade_fee>99</refund_upgrade_fee>
                    <refund_modify_fee>99</refund_modify_fee>
                    <refund_segments>
                        <refund_segments>
                            <cabin_class>mXAMw2RecA</cabin_class>
                            <flight_no>mcmytpbwyy</flight_no>
                            <dep_time>1609748813406</dep_time>
                            <arr_city>PEFjkhEQJ9</arr_city>
                            <dep_city>reRqNB53Br</dep_city>
                            <cabin>MQfSonazHQ</cabin>
                            <segment_index>37</segment_index>
                            <arr_airport>24gsWJYBiB</arr_airport>
                            <dep_airport>xs6q8sSSWk</dep_airport>
                            <arr_time>1609748813406</arr_time>
                            <od_index>65</od_index>
                        </refund_segments>
                    </refund_segments>
                    <refund_amount>10000</refund_amount>
                    <ticket_price>10000</ticket_price>
                    <passenger_type>1</passenger_type>
                    <taxes>
                        <tax>
                            <tax_code>CN</tax_code>
                            <amount>100</amount>
                            <not_refund_amount>100</not_refund_amount>
                        </tax>
                    </taxes>
                    <total_modify_fee>100</total_modify_fee>
                    <total_upgrade_fee>100</total_upgrade_fee>
                    <real_price>10000</real_price>
                    <refund_item_type>2</refund_item_type>
                    <pnr_xe>0</pnr_xe>
                    <pnr_xe_time>1609748813397</pnr_xe_time>
                    <sur_name>ZHANG</sur_name>
                    <given_name>SAN</given_name>
                    <cert_period>2026-03-15</cert_period>
                    <nationality>CN</nationality>
                    <cert_issue_country>CN</cert_issue_country>
                    <birthday>1987-04-05</birthday>
                    <gender>1</gender>
                </refund_list>
            </refund_list>
            <sla>RMpK6hrrRj</sla>
            <currency>H6hvhlDEcf</currency>
            <apply_time>1609748813397</apply_time>
            <status>43</status>
            <refuse_reason>拒绝</refuse_reason>
            <apply_reason_type>12</apply_reason_type>
            <supplement>1</supplement>
            <tags>
                <string>[&quot;URGENT&quot;]</string>
            </tags>
            <refund_way_type>1</refund_way_type>
            <attachment>
                <string>xxx.xxx.xxx</string>
            </attachment>
            <trip_type>1</trip_type>
            <correlation_order_id>1123123</correlation_order_id>
            <involuntary_pass_type>0</involuntary_pass_type>
            <refund_service_type>1</refund_service_type>
            <ful_fill_ment_deadline>2024-04-19 18:00:00</ful_fill_ment_deadline>
            <fee_back_fill_deadline>2024-04-19 18:00:00</fee_back_fill_deadline>
            <order_item_type>2</order_item_type>
        </data>
        <success>true</success>
        <error_code>000</error_code>
        <error_msg>异常信息</error_msg>
    </result>
</alitrip_agent_flight_sell_refund_detail_response>

{
    "alitrip_agent_flight_sell_refund_detail_response":{
        "result":{
            "data":{
                "apply_id":"RdSDumQCBZ",
                "voluntary":1,
                "reason":"7VfozcVjFB",
                "agent_id":1180023,
                "domestic_intl":1,
                "order_id":"cNkiP9AqRb",
                "refund_list":{
                    "refund_list":[
                        {
                            "passenger_name":"hbIqVfWk69",
                            "refund_fee":2,
                            "tickets":{
                                "string":[
                                    ""
                                ]
                            },
                            "refund_upgrade_fee":99,
                            "refund_modify_fee":99,
                            "refund_segments":{
                                "refund_segments":[
                                    {
                                        "cabin_class":"mXAMw2RecA",
                                        "flight_no":"mcmytpbwyy",
                                        "dep_time":"1609748813406",
                                        "arr_city":"PEFjkhEQJ9",
                                        "dep_city":"reRqNB53Br",
                                        "cabin":"MQfSonazHQ",
                                        "segment_index":37,
                                        "arr_airport":"24gsWJYBiB",
                                        "dep_airport":"xs6q8sSSWk",
                                        "arr_time":"1609748813406",
                                        "od_index":65
                                    }
                                ]
                            },
                            "refund_amount":10000,
                            "ticket_price":10000,
                            "passenger_type":1,
                            "taxes":{
                                "tax":[
                                    {
                                        "tax_code":"CN",
                                        "amount":100,
                                        "not_refund_amount":100
                                    }
                                ]
                            },
                            "total_modify_fee":100,
                            "total_upgrade_fee":100,
                            "real_price":10000,
                            "refund_item_type":2,
                            "pnr_xe":0,
                            "pnr_xe_time":"1609748813397",
                            "sur_name":"ZHANG",
                            "given_name":"SAN",
                            "cert_period":"2026-03-15",
                            "nationality":"CN",
                            "cert_issue_country":"CN",
                            "birthday":"1987-04-05",
                            "gender":1
                        }
                    ]
                },
                "sla":"RMpK6hrrRj",
                "currency":"H6hvhlDEcf",
                "apply_time":"1609748813397",
                "status":43,
                "refuse_reason":"拒绝",
                "apply_reason_type":12,
                "supplement":1,
                "tags":{
                    "string":[
                        "[\"URGENT\"]"
                    ]
                },
                "refund_way_type":1,
                "attachment":{
                    "string":[
                        "xxx.xxx.xxx"
                    ]
                },
                "trip_type":1,
                "correlation_order_id":"1123123",
                "involuntary_pass_type":0,
                "refund_service_type":1,
                "ful_fill_ment_deadline":"2024-04-19 18:00:00",
                "fee_back_fill_deadline":"2024-04-19 18:00:00",
                "order_item_type":2
            },
            "success":true,
            "error_code":"000",
            "error_msg":"异常信息"
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

机票API

alitrip.agent.flight.sell.refund.detail (销售退票单详情)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈