api_change-cn

API Change Log

2019/11/07

报价接口数据-单酒店、多酒店

新增用户身份字段，可限制报价仅部分用户可见；
新增预定区域限制字段，可限制报价仅部分区域可见；
新增提前预订时间字段，可限制报价可提前预订天数。

2018/08/31

1.酒店基础数据(代理商提供)

将之前版本hotel@name可传中文或英文，修改为请使用英文名称；
新增hotel@nameCN，酒店名称（中文）；
新增hotel@coordinateProvider，坐标提供者；
新增hotel@longitude，经度；
新增hotel@latitude，维度；

2.报价接口数据-单酒店、多酒店

将之前版本hotel@name可传中文或英文，修改为请使用英文名称；
新增hotel@nameCN，酒店名称（中文）；
新增hotel@coordinateProvider，坐标提供者；
新增hotel@longitude，经度；
新增hotel@latitude，维度；
将之前版本的room@name，可传中文或英文，修改为请使用英文名称；
新增room@nameCN，房型名称（中文）；
新增window，窗；

2016/10/28

变价推送

变价推送功能是指通过代理商提供的变价接口，当酒店信息发生变化时，推送发生变化的酒店，从而达到：

降低去哪儿对代理商报价接口的访问频率，从而提升代理商报价接口稳定性；
降低报价缓存时间，使消费者所见报价更接近实时报价；

2016/05/20

Price API--多酒店
- 为降低变价频次；
- 降低减少对代理商的访问次数。
现在, 我们额外提供了一个报价接口，使用去哪儿城市代码或者多个代理商酒店ID作为请求参数.

2016/05/16

关于 cancelRequest

如果requiredAction存在, 意味着这个请求是从QTA后台发起的强制取消(经过消费者、去哪儿、代理商三方沟通).

原API描述：

代理商一侧需要返回一个带 result = PROCESSING的,随后代理商需要调用订单操作接口(opt=AGREE_UNSUBSCRIBE or REFUSE_UNSUBSCRIBE).

生产环境：

qta主系统的订单状态已经变更为"canceled", 此状态为订单终态。所以代理商无需再进行操作.

删除如下内容；

1) opt : AGREE_UNSUBSCRIBE / REFUSE_UNSUBSCRIBE

2) cancelResponse : result= PROCESSING.

2016/04/08

qunarOrderQueryResponse--channel,deposit：

这两个节点 (channel,deposit)没有任何作用, 特此删除(不影响业务逻辑).

<qunarOrderQueryResponse>
    <orderInfo>
        <orderNum>j3gm141219163017759</qunarOrderNum><!-- unique order id at Qunar  -->
        <orderId>9987654</orderId><!-- unique order id at wrapper -->
        <payType>PREPAY</payType>
        <qunarStatus>50</qunarStatus>
        <channel>MAIN</channel>
        <deposit></deposit>
        <roomNum>2</roomNum>


</qunarOrderQueryResponse>

改为 :

<qunarOrderQueryResponse>
    <orderInfo>
        <orderNum>j3gm141219163017759</orderNum><!-- unique order id at Qunar  -->
        <orderId>9987654</orderId><!-- unique order id at wrapper -->
        <payType>PREPAY</payType>
        <qunarStatus>50</qunarStatus>
        <roomNum>2</roomNum>

2016/03/02

priceResponse--occupancyNumber：

如果代理商的报价会随着入住人数的变化而变化.

请在<priceResponse>的字段maxOccupany之后增加属性occupancyNumber .

例如, 如果报价属于“一人入住，但物理房型最大可入住人数为2”, 请返回如此报价: maxOccupancy="2" occupancyNumber="1"

 <room id="9986" name="特色房" broadband="FREE" payType="PREPAY" prices="200|200" status="ACTIVE|ACTIVE" counts="5|5" 
        roomRate="180|180" taxAndFee="20|20" maxOccupancy="2" occupancyNumber="2"
        freeChildrenNumber="1" freeChildrenAgeLimit="8" instantConfirmRoomCount="3|3" wifi="FREE" 
        checkinTime="" checkoutTime="" area="" >
        ...

2016/2/29

bedType 为 大/双床：

目前代理商的大/双床信息，报文如：

    <bedType relation="OR">
        <beds code="OTHERS" count="1" desc="1 Double Bed or 2 Single Beds" seq="1" size=""/>
    </bedType>

此种是不能够正确在前端给用户提供大/双床选择的，需要修改为如下:

    <bedType relation="OR">
        <beds code="Double" count="1" desc="1 Double Bed " seq="1" size=""/>
        <beds code="Single" count="2" desc="2 Single Beds" seq="2" size=""/>
    </bedType>

bedType 为其他：

Example:

    <bedType relation="">
        <beds code="OTHERS" count="1" desc="1 Double Bed and 1 Sofa Bed " seq="1" size=""/>
    </bedType>

此种情形下，需要将`desc`描述清楚

如果床型特殊, 可以使用"OTHERS"，且 desc 不能为空.

如房间中有多张床，请参照示例写在一个beds中，用desc描述清楚即可.