注意:以下文档只适用于TOP接口,请谨慎使用!

taobao.alitrip.flightchange.add (航变信息录入接口)

代理商调用航变录入接口, 简要描述:完成航变信息的自动录入后飞猪机票平台会发生的动作是匹配所有该代理人的订单,如果接口参数指定了飞猪机票订单号,发生的动作是匹配该代理人的指定订单; 找到与航变航班相关的订单给旅客下发航变短信并出发IVR自动外呼旅客。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
flight_change_data_do FlightChangeDataDO 必须 录入参数类
  • └ new_arr_airport
  • String
  • 可选
  • SHA
  • 航班最新到达机场三字码, 字符长度3;仅当flightChangeType=2,该参数必填
  • └ old_arr_airport
  • String
  • 必须
  • SHA
  • 原到达机场三字代码, 字符长度3
  • └ old_dep_time_str
  • String
  • 必须
  • 2016-08-01
  • 原航变日期 ,格式:yyyy-MM-dd
  • └ flight_change_type
  • Number
  • 必须
  • 1
  • 航变类型,1:航班取消 2:航班变更
  • └ old_flt_num
  • String
  • 必须
  • CA1710
  • 原航班号(如果是二次航变,该参数为第一航变后最新的航班号。eg:第一航变 航班号从CA123变更到CA456,那第二次航变的原航班应该为CA456)
  • └ new_dep_time_str
  • String
  • 可选
  • 2016-08-01 12:20
  • 航班最新计划起飞时间,仅当flightChangeType=2,该参数必填;录入格式:yyyy-MM-dd HH: mm
  • └ new_dep_airport
  • String
  • 可选
  • PEK
  • 航班最新出发机场三字码, 字符长度3;仅当flightChangeType=2,该参数必填
  • └ old_dep_airport
  • String
  • 必须
  • PEK
  • 原出发机场三字代码, 字符长度3
  • └ new_flt_num
  • String
  • 可选
  • CA1710
  • 变更到的最新航班号,仅当flightChangeType=2,该参数必填
  • └ biz_type
  • Number
  • 必须
  • 1
  • 业务类型,0:国内机票 1:国际机票
  • └ order_id
  • Number
  • 可选
  • 0
  • 飞猪机票订单号,如果输入了该参数,平台只会给该指定订单发送航变,如果不输入该参数,则会处理代理商的所有订单;正常的延误航变该参数一般不需要,如果是航班保护,大部分情况该参数应该都是必填的,因为航班保护基本每个订单保护的新航班可能都不一样。
  • └ new_arr_time_str
  • String
  • 可选
  • 2016-08-01 12:20
  • 最新到达时间
  • └ out_order_no
  • String
  • 可选
  • ACENQ20230402000625078
  • 特殊场景订单号(一般不用传)
  • └ need_confirm_seat
  • Number
  • 可选
  • 1
  • 非必填,1无须确认座位,2已确认座位,3待确认座位
  • └ agent_proof_type
  • Number
  • 可选
  • 1
  • 凭证类型 1.截图凭证(邮件/对话记录/航班动态页面) 2.文本平镇(邮件内容/PNR内容/短信内容)
  • └ agent_proof
  • String
  • 可选
  • https://images1.fliggy.com/upload/flight/pLt4khgg5t5160ba7e3a20301e.jpeg?OSSAccessKeyId=LTAI5t8JxKnT7rfoJ9Hsccvj&Expires=1705900750&Signature=NA44XxFAe6kuDlBW8%2BtzS7aTdio%3D
  • 航变凭证内容, 凭证类型为1时,传凭证地址; 为2时上传凭证内容
  • └ change_reason_code
  • String
  • 可选
  • Weather_conditions
  • 航变原因枚举,包括Airline("航空公司"), Weather_conditions("天气"), Public_safety("公共安全"), Mechanical_failure("飞机故障"), Airspace_activities("空域活动"), Airport("机场"), Military_activities("军事活动"), Engineering_and_maintenance_issues("工程机务"), Passenger("旅客"), Air_Traffic_Flow_Control("流量控制"), Airline_scheduling("航空公司计划"), Previous_flight_late_arrival("前序航班晚到"), Air_Traffic_Control("空管"), Flight_rescheduling("航班调时"), Pandemic("疫情"), Other_passenger_related("其他用户原因")

响应参数

名称 类型 示例值 描述
result ResultDo 0 result
  • └ err_msg
  • String
  • 成功
  • 错误信息
  • └ err_code
  • String
  • 200
  • 错误码
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFlightchangeAddRequest req = new AlitripFlightchangeAddRequest();
AlitripFlightchangeAddRequest.FlightChangeDataDO obj1 = new AlitripFlightchangeAddRequest.FlightChangeDataDO();
obj1.setNewArrAirport("SHA");
obj1.setOldArrAirport("SHA");
obj1.setOldDepTimeStr("2016-08-01");
obj1.setFlightChangeType(1L);
obj1.setOldFltNum("CA1710");
obj1.setNewDepTimeStr("2016-08-01 12:20");
obj1.setNewDepAirport("PEK");
obj1.setOldDepAirport("PEK");
obj1.setNewFltNum("CA1710");
obj1.setBizType(1L);
obj1.setOrderId(0L);
obj1.setNewArrTimeStr("2016-08-01 12:20");
obj1.setOutOrderNo("ACENQ20230402000625078");
obj1.setNeedConfirmSeat(1L);
obj1.setAgentProofType(1L);
obj1.setAgentProof("https://images1.fliggy.com/upload/flight/pLt4khgg5t5160ba7e3a20301e.jpeg?OSSAccessKeyId=LTAI5t8JxKnT7rfoJ9Hsccvj&Expires=1705900750&Signature=NA44XxFAe6kuDlBW8%2BtzS7aTdio%3D");
obj1.setChangeReasonCode("Weather_conditions");
req.setFlightChangeDataDo(obj1);
AlitripFlightchangeAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_flightchange_add_response>
    <result>
        <err_msg>成功</err_msg>
        <err_code>200</err_code>
        <success>true</success>
    </result>
</alitrip_flightchange_add_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>

错误码解释

错误码 错误描述 解决方案
-101 无匹配订单记录 校验是否为已发送航变或无此订单

API工具

如何获得此API

FAQ

返回
顶部