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

航变信息录入接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
flight_change_data_dto FlightChangeDataDTO 必须 请求参数
  • └ 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
  • 可选
  • agentProof
  • 航变凭证内容, 凭证类型为1时,传凭证地址; 为2时上传凭证内容
  • └ change_reason_code
  • String
  • 可选
  • Weather_conditions
  • Weather_conditions
  • └ agent_developer_id
  • String
  • 可选
  • f3690c6763a34744acxx
  • 开发者id
  • └ agent_developer_secret
  • String
  • 可选
  • f3690c6763a34744acxx
  • 开发者秘钥
  • └ agent_id
  • Number
  • 可选
  • 123
  • 店铺id

响应参数

名称 类型 示例值 描述
result ResultDO 异步获取历史数据接口返回结果
  • └ msg
  • String
  • 错误
  • 响应msg
  • └ code
  • String
  • 403
  • 响应code
  • └ success
  • Boolean
  • true
  • 请求成功标识,成功:true,失败:false
  • └ module
  • Number
  • 123456
  • 任务数据,请求成功时返回任务id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripAgentFlightchangeAddRequest req = new AlitripAgentFlightchangeAddRequest();
AlitripAgentFlightchangeAddRequest.FlightChangeDataDTO obj1 = new AlitripAgentFlightchangeAddRequest.FlightChangeDataDTO();
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("agentProof");
obj1.setChangeReasonCode("Weather_conditions");
obj1.setAgentDeveloperId("f3690c6763a34744acxx");
obj1.setAgentDeveloperSecret("f3690c6763a34744acxx");
obj1.setAgentId(123L);
req.setFlightChangeDataDto(obj1);
AlitripAgentFlightchangeAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_agent_flightchange_add_response>
    <result>
        <msg>错误</msg>
        <code>403</code>
        <success>true</success>
        <module>123456</module>
    </result>
</alitrip_agent_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部