飞猪 - 开放平台

请求地址：

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

名称	类型	是否必须	示例值	描述
extend_attributes	String	可选	{}	扩展字段
out_id	String	可选	123	接入方产品id
taobao_id	Number	可选	123	淘宝政策id
top_policy_do	TopPolicyDo	可选		国际机票销售规则
└ airline String 必须 CA 航空公司，航空公司两字码，如CA └ allow_price_range String 可选 100-1000 价格区间，空表示默认值为0-999999默认为正整型上限必须大于下限 └ arr_cities String 可选 SHA,NYC 目的地，空表示所有航线都适用可录入格式：1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市 └ buy_ticket_notice String 可选本产品仅限中国大陆国际的乘客预定；成功预定和出票赠送机上WIFI券购票须知，非必输长度小于300字符只在退票规定不为空时才会生效 └ cabin_restrict String 可选 F,C,Y 舱位，空表示所有舱位都适用多个用,分隔 └ cabin_restrict_type String 可选适用适用/例外舱位，可选：适用、例外，如果舱位有值，则必须输入适用或例外 └ child_sale_rebase String 可选 1 儿童留钱，非必输;为整型;支持负数;单位元 └ child_sale_retention String 可选 1 儿童返点，非必输;可输入负值;范围-100至100之间，可保留2位小数 └ code_sharing_type String 可选仅限同集团代码共享适用代码共享适用类型，空：不允许代码共享;可以选值：仅限同集团代码共享适用、代码共享适用、不允许代码共享、 └ dep_cities String 可选 SHA,NYC 始发地，空表示所有航线都适用可录入格式：1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市 └ dep_date String 必须 2013-09-11~2013-10-10 去程旅行日期，必填项；支持添加多对日期多段用,分隔；可支持2013-01-01或2013/01/01格式输入；范围用~表示 └ exclude_arr_cities String 可选 SHA,NYC 例外目的地，空表示所有航线都适用可录入格式：1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市 └ exclude_dep_cities String 可选 SHA,NYC 例外始发地，空表示所有航线都适用可录入格式：1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市 └ fare_basis_allowed String 可选 F% 适用fareBasis，空表示所有都适用支持数字字母组合支持多个,支持通配符%不限制长度的通配符,只支持首或末位一个% └ fare_basis_forbidden String 可选 F% 例外fareBasis，空表示所有都适用支持数字字母组合支持多个,支持通配符%不限制长度的通配符,只支持首或末位一个% └ fare_source String 可选平台运价运价来源，空：表示平台运价; 此处为单选,输入平台运价，表示平台运价，不同的接入方可选值不一样 └ fare_type String 可选文件运价可适用运价渠道，空：表示都适用运价来源为:平台运价时，此处选项为：私有运价, 公布运价。以上选项若多个用,分隔 └ flight_restrict String 可选 CA123,CA234-999 适用航班，同一航段之间用，隔开表示或的关系；不同航段之间用/隔开。 1 CA001-999,CA3000-3999 表示CA001至999以及3000至3999之间航班号的航班2 MU 表示所有MU开头的航班 3 CA(LH\AZ) 表示CA开头的实际承运人为LH或AZ的航班4 CA() 表示CA代码共享航班/CA开头的实际承运人为其他航空公司的航班5 CA(CA) 表示CA自营航班/CA实际承运航班；6 CA(OZ)001-999 表示CA开头航班号为001-999之间且实际承运人为OZ的航班；7 为空表示无限制 └ is_support_rt String 可选允许是否允许1/2RT组合销售规则，允许、不允许空表示：不允许 └ luggage_rule String 可选普通乘客：2件，每件23公斤行李额规定，非必输长度小于300字符。全部未使用可否退票，部分未使用可否退票，去程可否改期，回程可否改期，noshow是否有限制，与行李规定，必须全部为空或全部非空金牌产品该项必须为空 └ noshow_rule String 可选起飞前2小时内取消视作误机，误机不允许改期不允许退票误机罚金说明，非必输长度小于300字符只在退票规定不为空时才会生效 └ office_no String 可选 OFFICE 预定OFFICE，空表示默认优先级最高OFFICE，可输入OFFICE，校验必须为配置中存在的OFFICE └ passenger_type String 可选普通成人身份，1.不得为空2.可选：普通/学生 3多个使用,分隔 └ policy_id String 可选 CA12345 产品编号，内容可空，支持字母和数字,最多50个字符 └ product_type String 可选普通商品类型，非必输；默认为普通可填写为金牌，普通或极速出票。如果没有相应产品权限，则无法投放 └ refund_rule String 可选退票免费退票规定，非必输长度小于300字符请同时录入退票规定、改签规定和行李额规定 └ reissue_rule String 可选改期费为票价的30% 改签规定，非必输长度小于300字符请同时录入退票规定、改签规定和行李额规定 └ remark String 可选销售规则备注备注信息，销售规则备注,最多300个字符 └ ret_date String 可选 2013-09-11~2013-10-10,2014-09-11~2014-10-10 回程旅行日期，非必填，支持添加多对日期多段用,分隔；可支持2013-01-01或2013/01/01格式输入；范围用~表示 └ rt_commission_formula String 可选各取各 1/2RT计算方式，空：表示取严，可录入各取各或者取严，表示1/2RT佣金计算方式是各取各或者取严。 └ sale_date String 必须 2013-01-01~2013-02-01 销售日期，必填项；销售日期只能输入一段;日期对为左右都是闭区间格式：可支持2013-01-01或2013/01/01格式输入；范围用~表示 └ sale_rebase String 可选 12 留钱，返点和留钱至少二选一 └ sale_retention String 可选 13 返点，可输入负值范围-100至100之间，可保留2位小数与留钱固定金额二选一必输 └ service_level String 可选头等服务等级，默认值空：表示所有服务等级适用头等公务超值经济经济可多选，用,分隔 └ transfer_cities String 可选 SHA 中转点，空表示所有航线都适用可录入格式：1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市 └ transfer_type String 可选中转中转类型（是否直达），空：表示不限，即直达中转都适用，可选：直达、中转 └ travel_type String 可选单程航程种类，可选：单程、往返、空为不限 └ extend_attributes String 可选 {} 扩展字段，预留 └ is_allow_union_airline String 可选允许不同航司联运，非必输；可输入允许或不允许，空表示不允许 └ channel_id_desc String 可选 amadus 渠道名称，非必输，不同的接入方可选值不一样 └ is_can_all_refund String 可选是全部未使用可否退票，可输入:是，否。金牌产品该项必须为空 └ refund_fee_all_unused String 可选 200-72-10%-48-1000-0- 【全部未使用可否退票】为是时，此项为必填项。可输入格式如：200-72-300-48-1000-0-，表示72小时前退票手续费200；48小时到72小时，退票手续费300；飞机起飞不足48小时；退票手续费1000；飞机起飞后不予改期（输入）；或 10%-72-30%-48-50%-0-，表示72小时前退票手续费为票面价的10%；48小时到72小时，退票手续费为票面价的30%；飞机起飞不足48小时；退票手续费为票面价的50%；飞机起飞后不予退票（输入）； └ refund_currency_all_unused String 可选 CNY 全部未使用退票币种，只能录入币种三字码，默认值CNY └ refund_fee_type_all_unused String 可选全程全部未使用退票费用收取方式，按每个航段收还是全程收(0:全程, 1：每个航段，默认值：全程) └ is_can_part_refund String 可选是部分未使用可否退票，可输入：是，否。金牌产品该项必须为空 └ refund_fee_part_unused String 可选 200-72-10%-48-1000-0-* 部分未使用退票费用,格式同【全部未使用退票费用】，【部分未使用可否退票】为是时，此项为必填项 └ refund_currency_part_unused String 可选 CNY 部分未使用退票币种，可录入币种三字码，默认值CNY └ refund_fee_type_part_unused String 可选全程部分未使用退票费用收取方式，按每个航段收还是全程收(0:全程, 1：每个航段，默认值：全程) └ can_dep_change String 可选否去程可否改期，可输入是或否。金牌产品该项必须为空 └ dep_change_fee String 可选 200-72-300-48-1000-0-* 去程改期费用，格式说明参考【全程未使用退票费用】，注意，改期费用不能录入百分比，【去程可否改期】为是时为必填项 └ dep_change_currency String 可选 CNY 去程改期币种，可录入币种三字码，默认值CNY └ dep_change_fee_type String 可选全程去程改期费用收取方式,按每个航段收还是全程收(0:全程, 1：每个航段，默认值：全程) └ can_ret_change String 可选否回程可否改期，可输入是或否。金牌产品该项必须为空 └ ret_change_fee String 可选 200-72-300-48-1000-0-* 回程改期费用，格式同【去程改期费用】，【回程可否改期】为是时为必填 └ ret_change_currency String 可选 CNY 回程改期币种，可录入币种三字码，默认值CNY └ ret_change_fee_type String 可选全程回程改期费用收取方式，按每个航段收还是全程收(0:全程, 1：每个航段，默认值：全程) └ noshow_restrict String 可选是 NOSHOW是否有限制，可输入是或否。金牌产品该项必须为空 └ noshow_time_restrict String 可选 10 NOSHOW时限,只能录入整数，【NOSHOW是否有限制】为是时，此项为必填项 └ noshow_time_restrict_unit String 可选小时 NOSHOW时限单位(小时/天, 默认为小时) └ noshow_rule_type String 可选不可退票,不可改期 NOSHOW规则，可录入多个，多个用逗号分隔。可录入不可退票、不可改期，不可退票,不可改期 └ noshow_fee String 可选 3000 NOSHOW金额，只能录入整数或百分比，【NOSHOW是否有限制】为是,【NOSHOW规则】不是不可退票,不可改期时，此项为必填项 └ noshow_currency String 可选 CNY NOSHOW币种,可录入币种三字码，默认值CNY └ vip_code String 可选 123abc 开票大客户编码，最大长度50 └ gv2_child_rule String 可选是是否适用小团，可选值是或否 └ nationality String 可选 CN 国籍限制，可输入国家二字码，多个用逗号分隔，最多不超过20个 └ exclude_nationality String 可选 CN 除外国籍限制，可输入国家二字码，多个用逗号分隔，最多不超过20个 └ passenger_age String 可选 1-99 年龄限制，格式为1-99,1-或者-99 └ presale_period String 可选 10 提前销售天数限制 └ receipts String 可选电子行程单必填项赋值范围:电子行程单,旅行发票,差额行程单发票,等额行程单 └ can_oj String 可选不支持缺口是否支持缺口, 赋值范围:不支持缺口,只支持缺口,不限 └ default_od_deny String 可选 BJS-LAX,TC3-CN 例外航线,默认销售规则, 格式为xxx-xxx,xxx-xxx ，英文逗号分开，区域类型与例外始发地的一致 └ airline_code_sharing String 可选 KA(CX/CX),CA(CZ) 航司代码共享范围 airline_code_sharing : 格式 KA(CX/CX),CA(CZ) 英文逗号分开，/ 分隔内部，航司二字码表示 └ child_change_fee_in_unused String 可选 200-72-300-48-1000-0-* 儿童回程改期费用，格式同成人，【回程可否改期】为是时为必填 └ child_change_fee_out_unused String 可选 200-72-300-48-1000-0-* 儿童去程改期费用，格式同成人，格式说明参考【全程未使用退票费用】，注意，改期费用不能录入百分比，【去程可否改期】为是时为必填项 └ child_refund_fee_part_unused String 可选 200-72-300-48-1000-0-* 儿童部分未使用退票费用，格式同成人，【部分未使用可否退票】为是时，此项为必填项 └ child_refund_fee_all_unused String 可选 200-72-300-48-1000-0-* 儿童全部未使用退票费用，格式同成人，【全部未使用可否退票】为是时，此项为必填项。可输入格式如：200-72-300-48-1000-0-，表示72小时前退票手续费200；48小时到72小时，退票手续费300；飞机起飞不足48小时；退票手续费1000；飞机起飞后不予改期（输入）；或 10%-72-30%-48-50%-0-，表示72小时前退票手续费为票面价的10%；48小时到72小时，退票手续费为票面价的30%；飞机起飞不足48小时；退票手续费为票面价的50%；飞机起飞后不予退票（输入）；

名称	类型	示例值	描述
extend_attributes	String	{}	扩展字段
taobao_id	Number	123	淘宝政策id

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripItPolicyUpdateRequest req = new AlitripItPolicyUpdateRequest();
req.setExtendAttributes("{}");
req.setOutId("123");
req.setTaobaoId(123L);
AlitripItPolicyUpdateRequest.TopPolicyDo obj1 = new AlitripItPolicyUpdateRequest.TopPolicyDo();
obj1.setAirline("CA");
obj1.setAllowPriceRange("100-1000");
obj1.setArrCities("SHA,NYC");
obj1.setBuyTicketNotice("本产品仅限中国大陆国际的乘客预定； 成功预定和出票赠送机上WIFI券");
obj1.setCabinRestrict("F,C,Y");
obj1.setCabinRestrictType("适用");
obj1.setChildSaleRebase("1");
obj1.setChildSaleRetention("1");
obj1.setCodeSharingType("仅限同集团代码共享适用");
obj1.setDepCities("SHA,NYC");
obj1.setDepDate("2013-09-11~2013-10-10");
obj1.setExcludeArrCities("SHA,NYC");
obj1.setExcludeDepCities("SHA,NYC");
obj1.setFareBasisAllowed("F%");
obj1.setFareBasisForbidden("F%");
obj1.setFareSource("平台运价");
obj1.setFareType("文件运价");
obj1.setFlightRestrict("CA123,CA234-999");
obj1.setIsSupportRt("允许");
obj1.setLuggageRule("普通乘客：2件， 每件23公斤");
obj1.setNoshowRule("起飞前2小时内取消视作误机， 误机不允许改期不允许退票");
obj1.setOfficeNo("OFFICE");
obj1.setPassengerType("普通");
obj1.setPolicyId("CA12345");
obj1.setProductType("普通");
obj1.setRefundRule("退票免费");
obj1.setReissueRule("改期费为票价的30%");
obj1.setRemark("销售规则备注");
obj1.setRetDate("2013-09-11~2013-10-10,2014-09-11~2014-10-10");
obj1.setRtCommissionFormula("各取各");
obj1.setSaleDate("2013-01-01~2013-02-01");
obj1.setSaleRebase("12");
obj1.setSaleRetention("13");
obj1.setServiceLevel("头等");
obj1.setTransferCities("SHA");
obj1.setTransferType("中转");
obj1.setTravelType("单程");
obj1.setExtendAttributes("{}");
obj1.setIsAllowUnionAirline("允许");
obj1.setChannelIdDesc("amadus");
obj1.setIsCanAllRefund("是");
obj1.setRefundFeeAllUnused("200-72-10%-48-1000-0-*");
obj1.setRefundCurrencyAllUnused("CNY");
obj1.setRefundFeeTypeAllUnused("全程");
obj1.setIsCanPartRefund("是");
obj1.setRefundFeePartUnused("200-72-10%-48-1000-0-*");
obj1.setRefundCurrencyPartUnused("CNY");
obj1.setRefundFeeTypePartUnused("全程");
obj1.setCanDepChange("否");
obj1.setDepChangeFee("200-72-300-48-1000-0-*");
obj1.setDepChangeCurrency("CNY");
obj1.setDepChangeFeeType("全程");
obj1.setCanRetChange("否");
obj1.setRetChangeFee("200-72-300-48-1000-0-*");
obj1.setRetChangeCurrency("CNY");
obj1.setRetChangeFeeType("全程");
obj1.setNoshowRestrict("是");
obj1.setNoshowTimeRestrict("10");
obj1.setNoshowTimeRestrictUnit("小时");
obj1.setNoshowRuleType("不可退票,不可改期");
obj1.setNoshowFee("3000");
obj1.setNoshowCurrency("CNY");
obj1.setVipCode("123abc");
obj1.setGv2ChildRule("是");
obj1.setNationality("CN");
obj1.setExcludeNationality("CN");
obj1.setPassengerAge("1-99");
obj1.setPresalePeriod("10");
obj1.setReceipts("电子行程单");
obj1.setCanOj("不支持缺口");
obj1.setDefaultOdDeny("BJS-LAX,TC3-CN");
obj1.setAirlineCodeSharing("KA(CX/CX),CA(CZ)");
obj1.setChildChangeFeeInUnused("200-72-300-48-1000-0-*");
obj1.setChildChangeFeeOutUnused("200-72-300-48-1000-0-*");
obj1.setChildRefundFeePartUnused("200-72-300-48-1000-0-*");
obj1.setChildRefundFeeAllUnused("200-72-300-48-1000-0-*");
req.setTopPolicyDo(obj1);
AlitripItPolicyUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripItPolicyUpdateRequest req = new AlitripItPolicyUpdateRequest();
req.ExtendAttributes = "{}";
req.OutId = "123";
req.TaobaoId = 123L;
AlitripItPolicyUpdateRequest.TopPolicyDoDomain obj1 = new AlitripItPolicyUpdateRequest.TopPolicyDoDomain();
obj1.Airline = "CA";
obj1.AllowPriceRange = "100-1000";
obj1.ArrCities = "SHA,NYC";
obj1.BuyTicketNotice = "本产品仅限中国大陆国际的乘客预定； 成功预定和出票赠送机上WIFI券";
obj1.CabinRestrict = "F,C,Y";
obj1.CabinRestrictType = "适用";
obj1.ChildSaleRebase = "1";
obj1.ChildSaleRetention = "1";
obj1.CodeSharingType = "仅限同集团代码共享适用";
obj1.DepCities = "SHA,NYC";
obj1.DepDate = "2013-09-11~2013-10-10";
obj1.ExcludeArrCities = "SHA,NYC";
obj1.ExcludeDepCities = "SHA,NYC";
obj1.FareBasisAllowed = "F%";
obj1.FareBasisForbidden = "F%";
obj1.FareSource = "平台运价";
obj1.FareType = "文件运价";
obj1.FlightRestrict = "CA123,CA234-999";
obj1.IsSupportRt = "允许";
obj1.LuggageRule = "普通乘客：2件， 每件23公斤";
obj1.NoshowRule = "起飞前2小时内取消视作误机， 误机不允许改期不允许退票";
obj1.OfficeNo = "OFFICE";
obj1.PassengerType = "普通";
obj1.PolicyId = "CA12345";
obj1.ProductType = "普通";
obj1.RefundRule = "退票免费";
obj1.ReissueRule = "改期费为票价的30%";
obj1.Remark = "销售规则备注";
obj1.RetDate = "2013-09-11~2013-10-10,2014-09-11~2014-10-10";
obj1.RtCommissionFormula = "各取各";
obj1.SaleDate = "2013-01-01~2013-02-01";
obj1.SaleRebase = "12";
obj1.SaleRetention = "13";
obj1.ServiceLevel = "头等";
obj1.TransferCities = "SHA";
obj1.TransferType = "中转";
obj1.TravelType = "单程";
obj1.ExtendAttributes = "{}";
obj1.IsAllowUnionAirline = "允许";
obj1.ChannelIdDesc = "amadus";
obj1.IsCanAllRefund = "是";
obj1.RefundFeeAllUnused = "200-72-10%-48-1000-0-*";
obj1.RefundCurrencyAllUnused = "CNY";
obj1.RefundFeeTypeAllUnused = "全程";
obj1.IsCanPartRefund = "是";
obj1.RefundFeePartUnused = "200-72-10%-48-1000-0-*";
obj1.RefundCurrencyPartUnused = "CNY";
obj1.RefundFeeTypePartUnused = "全程";
obj1.CanDepChange = "否";
obj1.DepChangeFee = "200-72-300-48-1000-0-*";
obj1.DepChangeCurrency = "CNY";
obj1.DepChangeFeeType = "全程";
obj1.CanRetChange = "否";
obj1.RetChangeFee = "200-72-300-48-1000-0-*";
obj1.RetChangeCurrency = "CNY";
obj1.RetChangeFeeType = "全程";
obj1.NoshowRestrict = "是";
obj1.NoshowTimeRestrict = "10";
obj1.NoshowTimeRestrictUnit = "小时";
obj1.NoshowRuleType = "不可退票,不可改期";
obj1.NoshowFee = "3000";
obj1.NoshowCurrency = "CNY";
obj1.VipCode = "123abc";
obj1.Gv2ChildRule = "是";
obj1.Nationality = "CN";
obj1.ExcludeNationality = "CN";
obj1.PassengerAge = "1-99";
obj1.PresalePeriod = "10";
obj1.Receipts = "电子行程单";
obj1.CanOj = "不支持缺口";
obj1.DefaultOdDeny = "BJS-LAX,TC3-CN";
obj1.AirlineCodeSharing = "KA(CX/CX),CA(CZ)";
obj1.ChildChangeFeeInUnused = "200-72-300-48-1000-0-*";
obj1.ChildChangeFeeOutUnused = "200-72-300-48-1000-0-*";
obj1.ChildRefundFeePartUnused = "200-72-300-48-1000-0-*";
obj1.ChildRefundFeeAllUnused = "200-72-300-48-1000-0-*";
req.TopPolicyDo_ = obj1;
AlitripItPolicyUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripItPolicyUpdateRequest;
$req->setExtendAttributes("{}");
$req->setOutId("123");
$req->setTaobaoId("123");
$top_policy_do = new TopPolicyDo;
$top_policy_do->airline="CA";
$top_policy_do->allow_price_range="100-1000";
$top_policy_do->arr_cities="SHA,NYC";
$top_policy_do->buy_ticket_notice="本产品仅限中国大陆国际的乘客预定； 成功预定和出票赠送机上WIFI券";
$top_policy_do->cabin_restrict="F,C,Y";
$top_policy_do->cabin_restrict_type="适用";
$top_policy_do->child_sale_rebase="1";
$top_policy_do->child_sale_retention="1";
$top_policy_do->code_sharing_type="仅限同集团代码共享适用";
$top_policy_do->dep_cities="SHA,NYC";
$top_policy_do->dep_date="2013-09-11~2013-10-10";
$top_policy_do->exclude_arr_cities="SHA,NYC";
$top_policy_do->exclude_dep_cities="SHA,NYC";
$top_policy_do->fare_basis_allowed="F%";
$top_policy_do->fare_basis_forbidden="F%";
$top_policy_do->fare_source="平台运价";
$top_policy_do->fare_type="文件运价";
$top_policy_do->flight_restrict="CA123,CA234-999";
$top_policy_do->is_support_rt="允许";
$top_policy_do->luggage_rule="普通乘客：2件， 每件23公斤";
$top_policy_do->noshow_rule="起飞前2小时内取消视作误机， 误机不允许改期不允许退票";
$top_policy_do->office_no="OFFICE";
$top_policy_do->passenger_type="普通";
$top_policy_do->policy_id="CA12345";
$top_policy_do->product_type="普通";
$top_policy_do->refund_rule="退票免费";
$top_policy_do->reissue_rule="改期费为票价的30%";
$top_policy_do->remark="销售规则备注";
$top_policy_do->ret_date="2013-09-11~2013-10-10,2014-09-11~2014-10-10";
$top_policy_do->rt_commission_formula="各取各";
$top_policy_do->sale_date="2013-01-01~2013-02-01";
$top_policy_do->sale_rebase="12";
$top_policy_do->sale_retention="13";
$top_policy_do->service_level="头等";
$top_policy_do->transfer_cities="SHA";
$top_policy_do->transfer_type="中转";
$top_policy_do->travel_type="单程";
$top_policy_do->extend_attributes="{}";
$top_policy_do->is_allow_union_airline="允许";
$top_policy_do->channel_id_desc="amadus";
$top_policy_do->is_can_all_refund="是";
$top_policy_do->refund_fee_all_unused="200-72-10%-48-1000-0-*";
$top_policy_do->refund_currency_all_unused="CNY";
$top_policy_do->refund_fee_type_all_unused="全程";
$top_policy_do->is_can_part_refund="是";
$top_policy_do->refund_fee_part_unused="200-72-10%-48-1000-0-*";
$top_policy_do->refund_currency_part_unused="CNY";
$top_policy_do->refund_fee_type_part_unused="全程";
$top_policy_do->can_dep_change="否";
$top_policy_do->dep_change_fee="200-72-300-48-1000-0-*";
$top_policy_do->dep_change_currency="CNY";
$top_policy_do->dep_change_fee_type="全程";
$top_policy_do->can_ret_change="否";
$top_policy_do->ret_change_fee="200-72-300-48-1000-0-*";
$top_policy_do->ret_change_currency="CNY";
$top_policy_do->ret_change_fee_type="全程";
$top_policy_do->noshow_restrict="是";
$top_policy_do->noshow_time_restrict="10";
$top_policy_do->noshow_time_restrict_unit="小时";
$top_policy_do->noshow_rule_type="不可退票,不可改期";
$top_policy_do->noshow_fee="3000";
$top_policy_do->noshow_currency="CNY";
$top_policy_do->vip_code="123abc";
$top_policy_do->gv2_child_rule="是";
$top_policy_do->nationality="CN";
$top_policy_do->exclude_nationality="CN";
$top_policy_do->passenger_age="1-99";
$top_policy_do->presale_period="10";
$top_policy_do->receipts="电子行程单";
$top_policy_do->can_oj="不支持缺口";
$top_policy_do->default_od_deny="BJS-LAX,TC3-CN";
$top_policy_do->airline_code_sharing="KA(CX/CX),CA(CZ)";
$top_policy_do->child_change_fee_in_unused="200-72-300-48-1000-0-*";
$top_policy_do->child_change_fee_out_unused="200-72-300-48-1000-0-*";
$top_policy_do->child_refund_fee_part_unused="200-72-300-48-1000-0-*";
$top_policy_do->child_refund_fee_all_unused="200-72-300-48-1000-0-*";
$req->setTopPolicyDo(json_encode($top_policy_do));
$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=taobao.alitrip.it.policy.update' \
-d 'partner_id=apidoc' \
-d 'session=e283b6f6-906b-40ff-9a88-cf86136cf9b9' \
-d 'sign=E51FDF0FA529A0A7584C1C0BC17967B4' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-11-21+21%3A17%3A41' \
-d 'v=2.0' \
-d 'extend_attributes=%7B%7D' \
-d 'out_id=123' \
-d 'taobao_id=123' \
-d 'top_policy_do=null'

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

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

req.extend_attributes="{}"
req.out_id="123"
req.taobao_id=123
req.top_policy_do=""
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,"taobao.alitrip.it.policy.update");
add_param(pRequest,"extend_attributes","{}");
add_param(pRequest,"out_id","123");
add_param(pRequest,"taobao_id","123");
add_param(pRequest,"top_policy_do","数据结构JSON示例");
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('taobao.alitrip.it.policy.update', {
	'extend_attributes':'{}',
	'out_id':'123',
	'taobao_id':'123',
	'top_policy_do':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_it_policy_update_response>
    <extend_attributes>{}</extend_attributes>
    <taobao_id>123</taobao_id>
</alitrip_it_policy_update_response>

{
    "alitrip_it_policy_update_response":{
        "extend_attributes":"{}",
        "taobao_id":123
    }
}

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

taobao.alitrip.it.policy.update (【国际机票销售规则】单条更新)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ