预订宝/getHotelIdList
来自站长百科
getHotelIdList概述[ ]
- 接口地址:http://api.yudingbao.net/v1.0/hotel/hotelinfo.ashx?act=getHotelIdList
- 动作标识:getHotelIdList
- 参数:见参数说明
- 请求方式:GET
- 响应模式:JSON、JSONP、XML
注意:动作标识是大小写敏感的,请养成良好的编码习惯!
参数说明[ ]
参数名称 | 参数类型 | 说明 |
---|---|---|
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"] });