预订宝/getHotelIdList

来自站长百科
跳转至: 导航、​ 搜索

预订宝 | 系统设置 | 后台管理 |二次开发

getHotelIdList概述[ ]

  • 接口地址:http://api.yudingbao.net/v1.0/hotel/hotelinfo.ashx?act=getHotelIdList
  • 动作标识:getHotelIdList
  • 参数:见参数说明
  • 请求方式:GET
  • 响应模式:JSONJSONPXML

注意:动作标识是大小写敏感的,请养成良好的编码习惯!

参数说明[ ]

参数名称 参数类型 说明
cityCode string 城市编号。这是可选参数,当不指定城市编号时会返回所有签约酒店的编号的列表。

数据格式[ ]

  • 响应头:
    • Status:0为正常,非0表示处理请求时发生异常,通常是参数校验错误;
    • Messages:当Status为非0时该字段肯定包含一条或多条消息文本;
  • 响应体:
    • 本接口输出的响应体仅包含一个item节点,这表示一个酒店编号,整个ResponseBody是一个数组。
    • 酒店编号:以h开头的15位字符串。

对于数据格式的理解,请参考下列示例代码中的XML响应演示,其中每个字段都标注了数据类型(日期类型在XML响应中统一使用GMT格式,但被标注为string,请开发者注意)。

示例代码[ ]

以下示例代码是通过HTML表单实现了该接口的部分操作,您在开发过程中应当使用自己的平台语言来模拟这些操作以捕获响应体,然后对响应体做出相应的操作。

请求示例

<!--
    这是该接口的请求示例,该接口的访问类同于如下表单的提交,
     
    请注意:该表单使用控件的方法模拟了GET请求
-->
<form id="myForm" method="get" action="http://api.yudingbao.net/v1.0/hotel/hotelinfo.ashx">
    <p>
        <!--动作标识,注意动作标识是大小写敏感的-->
        <input id="act" name="act" value="getHotelIdList" type="text" />
    </p>
    <p>
        <!--城市编号,0101是北京的编号,如果不指定将返回所有酒店的编号序列-->
        <input id="cityCode" name="cityCode" value="0101" type="text" />
    </p>
    <p>
        <!--指定响应格式为XML,这里以XML为例-->
        <input id="format" name="format" value="xml" type="text" />
        <!--指定响应体应当是已格式化的,便于阅读代码,在生产环境中应当将该值设置为false-->
        <input id="indent" name="indent" value="true" type="text" />
        <!--产品编号。在我的账户-分销产品的应用列表中可以找到该参数的值。-->
        <input id="aid" name="aid" value="78663" type="text" />
        <!--接口密钥。在我的账户-分销产品的应用列表中可以找到该参数的值。-->
        <input id="key" name="key" value="0925ed633d24577eb3ffe13f00c55a4f9739f51a77eefb1dba29bb9568acddfd" type="text" />
         
        <!--应用程序授权编号及公钥,这是可选的-->
        <input id="sid" name="sid" value="" type="text">      
        <input id="sKey" name="sKey" value="" type="text">
    </p>
    <p>
        <input id="submit" name="submit" value="提交" type="submit">
    </p>
</form>



XML响应

<!--XML响应,响应体过大,已删节-->
<?xml version="1.0" encoding="utf-8"?>
<HttpResponse>
    <Status type="number">0</Status>
    <Messages type="array">
    </Messages>
    <ResponseBody type="array">
        <item type="string">h010t00101025</item>
        <item type="string">h010t00101039</item>
        <item type="string">h010t00101040</item>
        <item type="string">h010t00101044</item>
        <item type="string">h010t00101050</item>
        <item type="string">h010t00101069</item>
        <item type="string">h010t00101095</item>
        <item type="string">h010t00101141</item>
        <item type="string">h010t00101171</item>
        <item type="string">h010t00101197</item>
        <item type="string">h010t00101211</item>
        <item type="string">h010t00101223</item>
        <item type="string">h010t00101241</item>
        <item type="string">h010t00101252</item>
        <item type="string">h010t00101262</item>
    </ResponseBody>
</HttpResponse>



JSON响应

// Json响应,响应体过大,已删节
{
    "Status" : 0,
    "Messages" : [],
    "ResponseBody" : ["h010t00101025", "h010t00101039", "h010t00101040"]
}



JSONP响应

// JsonP响应,响应体过大,已删节
jsoncallback({
    "Status" : 0,
    "Messages" : [],
    "ResponseBody" : ["h010t00101025", "h010t00101039", "h010t00101040"]
});



参考来源[ ]

预订宝酒店预订网站系统使用手册导航

系统设置: 网站参数设置|图片功能设置|会员参数设置|有问必 答(论坛留言)设置|发布设置|首页默认城市设置
后台管理 客服设置|权限组管理|系统账户设置|个人设置|酒店 资讯|实用工具|网址导航|首页广告|会展信息|单页图 文|发布模型管理|分类管理|推荐属性管理|SEO关键字管理

评论管理|有问必答|会员管理|等级管理|酒店订单管理|手机推广终端

二次开发 API总体架构|鉴权方式|酒店地理信息API|酒店基础信息API酒店房价与房态API|酒店订单API|IP地址归属地查询系统|手机短信API|getRegions|getCity

getLandmarks|getHotelIdList|getHotelInfo|getHotelChainBrands|getHotelList|getHotelRooms|getHotelSummaryList|getOrderRoomStatus|submitOrder getOrderInfo|sendRegisterSMS|sendGetpassSMS|sendPromoteRegisterSMS