携程网站联盟api平台

携程网站联盟携程网站联盟API平台平台20集成开发指南集成开发指南文档编号P1109620902项目名网站联盟II期API20平台作者刘磊文件名携程旅行网网站联盟API20集成开发指南DOC保密等级审核人批准人文件状态草稿正在修改正式发布最后更新时间2012711版权申明本文件属于机密文件，所有权属于携程计算机技术（上海）有限公司。任何接触此件的人必须遵守以下规定1本文件及包含的内容均属于携程计算机技术（上海）有限公司资产。2未经携程计算机技术（上海）有限公司的书面同意，任何人不得对本文件的全部和/或部分内容进行任何形式的复制或传播扩散。版本历史版本/状态作者审核人发布日期备注V01刘磊201254V02刘磊201257增加国际机票相关内容V03陈浩刘磊2012581修改酒店搜索，可订检查，订单详情等契约及说明2更新错误代码V10盛凯刘磊20125101增加度假API说明2请求列表中删除订单提交APIV11刘磊20125111增加支付说明2增加静态文件下载地址V12刘磊2012641修改酒店静态信息接口说明，修正请求样例中的错误V13徐驰唐春龙刘磊刘磊20126111增加团购API相关说明2增加酒店API相关时间格式说明3增加酒店API价格计划促销活动说明V14王涛刘磊刘磊20127111增加国内机票API说明2修正团购API请求类型说明V14刘磊20128301OTA_HOTELSEARCH和OTA_HOTELRATEPLAN增加7天及香格里拉等酒店查询参数说明V15徐驰唐春龙2012926整理最新的说明文档目录1引言811目的812读者对象813文档内部约定8131文档字体约定814术语与缩写82方案概述921业务说明922业务流程1123API20平台介绍163数据格式2031请求地址2032请求类型2033测试及正式访问24331测试环境访问24332生产环境访问2434请求频次2435签名原始串2436签名算法25361MD5签名原理2537接口介绍26371用户USER263711用户生成OTA_USERUNIQUEID26372酒店HOTEL283721静态文件下载283722联通测试OTA_PING293723酒店查询OTA_HOTELSEARCH313724酒店静态信息查询OTA_HOTELDESCRIPTIVEINFO383725价格计划查询OTA_HOTELRATEPLAN533726价格缓存变化查询OTA_HOTELCACHECHANGE653727可订检查OTA_HOTELAVAIL693728订单生成OTA_HOTELRES813729订单取消OTA_CANCEL9837210订单变化查询OTA_HOTELRESNOTIF10237211订单详情查询OTA_READ10737212酒店列表查询D_HOTELSEARCH11837213酒店详情D_HOTELDETAIL13737214酒店订单列表查询D_HOTELORDERLIST16637215酒店订单详情查询D_HOTELORDERDETAIL17337216酒店评价查询D_HOTELCOMMENTLIST179373国内机票FLIGHT1823731静态文件下载1823732国内机票查询OTA_FLIGHTSEARCH1833733国内机票生成订单OTA_FLTSAVEORDER1913734国内机票取消订单OTA_FLTCANCELORDER2013735国内机票订单列表OTA_FLTORDERLIST2033736国内机票订单详情OTA_FLTVIEWORDER2083737国内机票订单变更OTA_GETSTATUSCHANGEDORDERS218374国际机票FLIGHT2213741静态文件下载2213742国际机票查询OTA_INTLFLIGHTSEARCH2213743机型信息查询OTA_FLTGETCRAFTINFOS2383744城市查询OTA_FLTGETCITYINFOS2413745机场查询OTA_FLTGETAIRPORTINFOS2443746航空公司信息OTA_FLTGETAIRLINEINFOS246375度假VACATIONS2503751度假地址选择器OTA_VACATIONADDRESSSELECTOR2503752度假城市列表（热门城市）OTA_VACATIONCITY2523753度假证件类型OTA_VACATIONCREDENTIALTYPE2553754度假配送方式OTA_VACATIONDELIVERTYPE2573755度假酒店OTA_VACATIONHOTELS2613756度假订单金额计算OTA_VACATIONORDERAMOUNT2693757度假临时订单生成OTA_VACATIONORDERCREATE2713758度假订单列表OTA_VACATIONORDERLIST2993759度假订单明细OTA_VACATIONORDERINFO30437510度假产品单选项OTA_VACATIONORDERITEM31837511产品查询列表OTA_VACATIONPACKAGELIST34737512产品明细OTA_VACATIONPACKAGEINFO35537513度假暂存订单详情OTA_VACATIONTMPORDERINFO36737514度假系统机票OTA_VACATIONSYSFLIGHT38037515度假可选项列表OTA_VACATIONORDEROPTION387376支付3983761在线支付3983762支付流水查询GETPAYMENTINFO400377团购4033771团购产品列表查询GROUPPRODUCTLIST4033772团购产品详细查看GROUPPRODUCTINFO4073773团购订单列表查询GROUPORDERLIST4143774团购订单生成GROUPCREATEORDER4173775团购券查询GROUPQUERYTICKETS4203776团购订单通知GROUPORDERCHANGE4233777团购产品通知GROUPPRODUCTCHANGE4263778团购券通知GROUPTICKETCHANGE4283779团购券取消GROUPCANCELTICKETS4314附录43341FAQ433411问我运行程序后怎么一直报错误代码签名错误433412问我怎么得到联盟身份（ALLIANCE）和站点密钥（SECRETKEY）434413问如果我只想使用酒店查询功能，然后跳转到CTRIPCOM完成预订怎么办434414问SYSTEMERRORNOCACHE在什么情况下出现的434415问我想通过API20的OTA_HOTELSEARCH接口查找某个城市的所有酒店，好像查不到请求如下。434416问酒店价格计划接口OTA_HOTELRATEPLAN可以一次查询多家酒店的价格吗434417问“SERVERRETURNEDHTTPRESPONSECODE413”是什么问题435418问我怎么知道我可以对接口的最大访问频次是多少435419问AREAID和BRANDCODE对应的数据在哪里能找到。4354110问OTA_HOTELRATEPLAN返回的结果里RATEPLANCODE“559401“RATEPLANCATEGORY“16“描述的是什么意思。4354111问我之前用的是酒店API10查询酒店信息的，请问现在提供的API20查询接口在使用方式上与API10有区别吗4364112问为什么我调用酒店API20的可订性检查接口会抛下面的错。4364113问酒店API20新预订接口下单时，担保信息必须要填写吗4364114问酒店API20新预订接口对于信用担保时录入的信用卡资料需要经过加密再传入吗4364115问酒店API20搜索接口节点INFOTYPE数字对应的类型有哪些。4374116问酒店API20的搜索接口提供最低价格的显示吗4374117问酒店API20的搜索接口提供国外酒店的搜索吗4374118问酒店API20价格计划接口返回的内容中描述的是什么信息。4384119问酒店API20调用中报错4384120问价格计划接口返回多个日期段的价格我该怎么取值。4384121问我用标准SOAP请求名为ASMX的服务接口为什么连不上。4384122问酒店API20新预订接口的联系方式CONTACTTYPE有哪几种43842错误代码4391引言11目的本文描述了网站联盟API平台对联盟伙伴提供的接口化预订解决方案，帮助联盟伙伴轻松实现酒店、机票、度假等在线旅游业务查询、预订、API功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了API平台的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数及参数类型的速查手册。12读者对象本文档的预期读者为业务需求人员、开发经理、项目经理、架构设计师、开发人员、测试人员、设计评审人员、用户文档编写者。13文档内部约定131文档字体约定着重说明字体对于本文中重要，易混淆，易疏忽的关键内容进行标记时使用的字体补充说明字体为便于读者理解，文本在某些描述之后会使用现有系统的实际情况举例，这是一种对于前文进行补充说明时使用的字体待定信息字体对于本文在编写时未确定，需与相关干系人进一步明确信息时使用的字体14术语与缩写术语/缩写解释APIAPPLICATIONPROGRAMMINGINTERFACE应用程序接口本文中指携程旅行网提供给联盟伙伴的业务数据接口WEBSERVICEURL指API20平台提供的业务WEBSERVICE的请求地址SOAPWEBSERVICE请求时使用的网络协议，API20平台中提供的所有API必须基于SOAP协议请求SECRETKEY密钥指联盟伙伴通过携程客户经理完成API平台权限开通后获得的针对每个SID的唯一身份认证标识。可通过登录联盟平台HTTP/UCTRIPCOM后通过站点列表中的站点详情页查看。请妥善保存此密钥并不得泄露给第三方XMLNS所有API20平台提供的API的命名空间为HTTP/CTRIPCOM信用卡加密在酒店部分API中，对于涉及到信用卡部分的数据需要进行加密。加密算法为DES对称加密。加密密钥为SECRETKEY的最后8位。时间格式时间字符串格式应当采用”ISO8601”标准20120615T15000000008002方案概述21业务说明API平台提供联盟伙伴自行通过携程旅行网提供的在线旅游业务API实现业务相关流程，避免了只能导流量而不能自主定义预订流程的问题联盟站点携程API平台酒店机票度假支付用户团购22业务流程携程API平台申请流程携程分销联盟平台携程客户经理联盟站点开始注册并开通分销联盟发送申请邮件至客户经理审核联盟站点申请审核结果邮件通知审核结果未通过生成SECRETKEY并配置API权限通过查看审核结果未通过通过分销联盟站点信息查询SECRETKEY通过结束携程酒店API20业务流程静态数据初始化预订联盟站点携程API平台开始读取静态数据导入本地数据库并完成匹配静态文件下载查询价格计划价格计划查询API酒店查询API酒店静态信息查询API本地酒店数据查询选择酒店价格缓存变化查询API更新并展示房型价格填写预订可订检查API生成预订单并本地存储订单生成API查询订单列表订单变化查询API查询订单详情订单详情查询API取消订单订单取消API结束携程国内机票API20业务流程静态数据初始化预订携程API平台联盟站点否是订单生成API含信用卡信息读取静态数据取消订单是否自行收取信用卡导入本地数据库并完成匹配填写预订自行收取信用卡信息信用卡支付导入本地数据库并完成匹配支付API开始订单变更通知API订单取消API查询订单列表查询航班国内机票航班查询API机场列表基础信息文件下载城市列表基础信息文件下载机型基础信息文件下载航空公司基础信息文件下载国内票台覆盖城市列表文件结束提交订单生成预订单并本地存储订单生成API不含信用卡信息联盟API平台业务接入（度假）产品查询预订支付订单查询携程API平台联盟站点开始用户输入查询关键字根据关键字获取查询参数查询产品查询并返回查询参数查询参数API查询并返回产品列表展示产品列表提供预订入口展示产品详情查询并返回产品详情产品详情API确认人数、出行人类型及出返日期查询并返回可选项列表可选项行程无关展示产品下可选项列表展示产品下单选项列表单选项行程相关API查询并返回单选项列表展示产品配送列表查询并返回单配送列表配送方式查询API确认出行联系人信息生成暂存订单生成暂存订单并返回暂存订单号暂存订单生成API在线支付信用卡在携程支付平台进行支付在线支付API根据暂存订单号获取订单详情和支付金额计算产品金额查询并返回订单总金额产品金额计算API自动提交订单并更新暂存订单状态支付结果通过展示订单详情客户查询订单查询订单并返回订单信息结束取消订单需通过客服电话进行查询参数API订单核对页订单列表查询API订单详情查询API不通过携程团购API20业务流程静态数据初始化预订携程API平台联盟站点开始城市静态文件下载读取静态数据导入本地数据库并完成匹配查询产品信息产品列表查询API本地查询团购产品选择产品产品详情API生成预订单并本地存储填写预订更新并展示产品详情订单生成API是否自行收款并发券支付API信用卡支付券取消API订单变更通知API查询订单列表取消券查询券列表结束券变更通知API券列表查询API发送/展示券信息否是导入本地数据库并完成匹配产品变更通知API23API20平台介绍提供方式WEBSERVICE协议SOAP请求报文1请求报文分为两个部分HEADER和REQUESTBODY2HEADER节点说明术语/缩写解释ALLIANCEID联盟ID指联盟伙伴通过网站联盟平台HTTP/UCTRIPCOM自行注册或通过携程客户经理注册后得到的唯一联盟标识类型为INT32SID站点ID指联盟伙伴通过网站联盟平台HTTP/UCTRIPCOM开通联盟并登录后自行添加或通过携程客户经理注册后得到的联盟下站点的唯一标识类型为INT32。一个联盟可拥有多个站点REQUESTTYPE请求类型请求类型必须同请求的WEBSERVICEURL中的请求页面名称一致（不区分大小写）。若WEBSERVICEURL和REQUESTTYPE不一致则会返回错误信息TIMESTAMP时间戳本文中指以197011000000000为基准，至当前时间为止的总秒数每次请求的时间戳必须在到达API后30秒内SIGNATURE签名以原始签名串按照顺序进行字符串拼接后MD5加密所得的字符串。MD5相关请见MD5签名章节3REQUESTBODY节点说明REQUESTBODY节点为具体业务请求XML，根据请求的业务不同而变化。具体可参见每个API的请求XML。酒店API部分请求说明例1酒店联通测试请求XML如下例2酒店订单取消请求XML如下总结通过以上示例可发现，对于所有的酒店请求，黑色部分每次请求均一致，蓝色部分为每个业务API的具体业务请求体，随着请求的API类型不同而变化。红色部分为每次请求的头节点，根据具体请求时间和请求类型而变化度假及其他API请求说明例1度假查询参数API请求XML如下上海例2度假查询参数API请求XML如下总结通过以上示例可发现，对于所有的度假请求，黑色部分每次请求均一致，蓝色部分为每个业务API的具体业务请求体，随着请求的API类型不同而变化。红色部分为每次请求的头节点，根据具体请求时间和请求类型而变化响应报文请求报文分为两个部分HEADER和RESPONSEBODYHEADER节点说明术语/缩写解释REFERENCEID唯一追踪编号对于每次请求均会返回此属性若在使用过程中发生问题可凭此联系携程技术人员寻求解决方案RESULTCODE请求结果标志SUCCESS成功FAIL失败UNKNOWN未知问题FORBIDDEN禁止访问ERROR错误RESULTNO错误编号开发人员可通过该编号在错误代码列表中查询具体错误信息或寻求携程技术人员支持RESULTMSG错误信息TIMESTAMP响应时间戳RESPONSEBODY节点说明RESPONSEBODY节点为具体业务响应XML，根据请求的业务不同而变化。具体可参见每个API的响应XML3数据格式31请求地址每个不同的API均提供不同的基于SOAP协议的请求地址。每次请求均需使用如下格式生成完整请求地址HTTP/API_URL/BUSINESSTYPE/REQUESTTYPEASMX其中参数分别代表如下内容API_URL所需请求的API访问地址，携程旅行网提供了测试环境供测试使用，在测试通过后请联系客户经理开通生产环境访问权限BUSINESSTYPE业务类型HOTEL,FLIGHT,VACATIONS,TRAINS,TUAN,USERREQUESTTYPE请求类型32请求类型不同业务的请求类型列表如下用户编号术语/缩写解释4801OTA_USERUNIQUEID用户生成酒店编号术语/缩写解释1101OTA_PING联通测试1102OTA_HOTELSEARCH酒店查询1103OTA_HOTELDESCRIPTIVEINFO酒店静态信息查询1104OTA_HOTELRATEPLAN价格计划查询1105OTA_HOTELCACHECHANGE价格缓存变化查询1106OTA_HOTELAVAIL可订检查1107OTA_HOTELRES订单生成1108OTA_CANCEL订单取消1109OTA_HOTELRESNOTIF订单变化查询1110OTA_READ订单详情查询1111D_HOTELSEARCH通过查询服务器直接查询酒店列表1112D_HOTELDETAIL通过查询服务器直接查询酒店详情1113D_HOTELORDERLIST通过查询服务器直接查询酒店订单列表1114D_HOTELORDERDETAIL通过查询服务器直接查询酒店订单详情1115D_HOTELCOMMENTLIST通过查询服务器直接查询酒店评论信息国内机票编号术语/缩写解释1201OTA_FLIGHTSEARCH国内航班查询1202OTA_GETFLIGHTGIFTS国内航班礼盒1203OTA_FLTSAVEORDER国内机票订单保存1204OTA_FLTCANCELORDER国内机票订单取消1205OTA_FLTVIEWORDER国内机票订单查询1206OTA_GETSTATUSCHANGEDORDERS国内机票订单变更查询1207OTA_FLTORDERLIST国内机票订单列表国际机票编号术语/缩写解释1311OTA_INTLFLIGHTSEARCH国际机票查询1301OTA_FLTGETCRAFTINFOS机型基础信息查询1302OTA_FLTGETCITYINFOS城市基础信息查询1303OTA_FLTGETAIRPORTINFOS机场基础信息查询1304OTA_FLTGETAIRLINEINFOS航线基础信息查询旅游度假编号术语/缩写解释1401OTA_VACATIONADDRESSSELECTOR地址选择器1402OTA_VACATIONCITY出发城市列表1403OTA_VACATIONCREDENTIALTYPE证件类型1404OTA_VACATIONDELIVERTYPE配送方式1405OTA_VACATIONHOTELS度假酒店列表1406OTA_VACATIONORDERITEM度假产品单选项1407OTA_VACATIONORDEROPTION度假产品可选项1408OTA_VACATIONORDERAMOUNT度假订单金额计算1409OTA_VACATIONORDERCREATE订单生成1410OTA_VACATIONORDERSUBMIT订单提交（支付完成后提交）1411OTA_VACATIONORDERLIST订单列表查询1412OTA_VACATIONORDERINFO订单详情查询1413OTA_VACATIONPACKAGELIST度假产品列表查询1414OTA_VACATIONPACKAGEINFO度假产品详情1415OTA_VACATIONTMPORDERINFO暂存订单详情1416OTA_VACATIONSYSFLIGHT度假系统机票查询团购编号术语/缩写解释1501GROUPPRODUCTLIST团购产品列表1502GROUPPRODUCTINFO团购产品详情1503GROUPCREATEORDER团购创建订单1504GROUP_SUBMITORDER团购提交订单1504GROUPQUERYTICKETS团购券列表1505GROUPCANCELTICKETS团购取消券1506GROUPORDERLIST团购订单列表1507GROUPPRODUCTCHANGE团购产品变更通知1508GROUPORDERCHANGE团购订单变更通知1509GROUPTICKETCHANGE团购券变更通知支付编号术语/缩写解释1601GETPAYMENTDETAIL支付查询1602PAYMENTENTRY在线支付33测试及正式访问331测试环境访问携程提供API20平台测试环境。测试环境API_URL为HTTP/OPENAPITESTCTRIPCOM暂未开通请在阅读完本手册后，联系客户经理开通测试环境访问权限及访问密钥。请务必于测试环境中确认调用程序没有缺陷。332生产环境访问请联系客户经理开通访问权限，并获取生产环境访问密钥。生产环境API_URL为HTTP/OPENAPICTRIPCOM34请求频次API平台根据不同联盟设置了每个API每分钟可访问次数限制。若超过访问次数限制则将返回RATELIMIT，并将锁定5分钟。若您的业务确实需要扩充访问次数，请联系携程网站联盟销客户经理为您配置。35签名原始串无论是用GET、POST还是XML，签名原始串组串方式都一致，除SIGNATURE字段外，待签名参数按照一定规则拼接而成，参数名、空值不传递，不参与签名。签名时字段名和字段值都采用原始值，不进行URLENCODE。MD5是一种摘要生成算法，通过在签名原始串后加上联盟通信密钥的内容，进行MD5运算，形成的摘要字符串即为签名结果。为了方便比较，签名结果统一转换为大写字符。36签名算法目前为MD5签名MD5签名计算公式SIGNATUREMD5TIMESTAMPALLIANCEIDMD5密钥TOUPPERSIDREQUESTTYPETOUPPER如签名原始参数串是ALLIANCEID1CHARSETUTF8CONTENTLENGTHLENGTHSOAPACTION“HTTP/CTRIPCOM/REQUEST“STRING6响应示例HTTP/11200OKCONTENTTYPETEXT/XMLCHARSETUTF8CONTENTLENGTHLENGTHSTRING7请求REQUESTXML150ADMINUSERREQUEST字段类型描述默认值可为空备注ALLIANCEIDINT联盟IDNSIDINT站点IDNUIDKEYSTRING本地用户名N调用方本地用户名相同值会返回相同用户标识8响应REQUESTRESULT159C906AAA284F54B60959D2C105FDE210USERRESPONSE字段类型描述默认值可为空备注UNIQUEUIDSTRING用户关联标识N唯一值RETCODEINT响应码0表示成功，其他表示失败OPERATIONTYPEINT响应类型0表示新生成的用户1表示已存在的用户372酒店HOTEL3721静态文件下载1代码表HTTP/UCTRIPCOM/UNION/DOC/CODELISTXLS2ERRORCODEHTTP/UCTRIPCOM/UNION/DOC/ERRCODEXLS3基础信息A包括以下内容I货币信息II国家信息III省份信息IV城市信息V商业区信息VI行政区信息B获取方式请询问客户经理。3722联通测试OTA_PING1服务地址HTTP/API_URL/HOTEL/OTA_PINGASMX2方法名REQUEST3方法参数REQUESTXMLSTRING4功能A酒店API联通性测试。BECHODATA用来输入要测试的文本C显示请求的内容，用来检测是否正确。5请求示例以下是SOAP11请求和响应示例。所显示的占位符需替换为实际值。POST/HOTEL/OTA_PINGASMXHTTP/11CONTENTTYPETEXT/XMLCHARSETUTF8CONTENTLENGTHLENGTHSOAPACTION“HTTP/CTRIPCOM/REQUEST“STRING6响应示例HTTP/11200OKCONTENTTYPETEXT/XMLCHARSETUTF8CONTENTLENGTHLENGTHSTRING7请求REQUESTXML测试文本OTA_PINGRQ字段类型描述默认值可为空备注ECHODATASTRING测试文本N8响应REQUESTRESULT阿什顿OTA_PINGRS字段类型描述默认值可为空备注ECHODATASTRING返回测试文本N3723酒店查询OTA_HOTELSEARCH1服务地址HTTP/API_URL/HOTEL/OTA_HOTELSEARCHASMX2方法名REQUEST3方法参数REQUESTXMLSTRING4功能A酒店所在城市ID，酒店名称、酒店星级等查询酒店信息列表。5请求示例以下是SOAP11请求和响应示例。所显示的占位符需替换为实际值。POST/HOTEL/OTA_HOTELSEARCHASMXHTTP/11CONTENTTYPETEXT/XMLCHARSETUTF8CONTENTLENGTHLENGTHSOAPACTION“HTTP/CTRIPCOM/REQUEST“STRING6响应示例HTTP/11200OKCONTENTTYPETEXT/XMLCHARSETUTF8CONTENTLENGTHLENGTHSTRING7请求REQUESTXMLOTA_HOTELSEARCHRQ字段类型描述默认值可为空备注CRITERIACRITERIA查询条件NCRITERIA字段类型描述默认值可为空备注AVAILABLEONLYINDICATORBOOL为真时，只返回可预订酒店；为假时，返回所有已激活酒店（针对不同渠道，可用性会不同）。TRUEYCRITERION字段类型描述默认值可为空备注HOTELREFHOTELREF酒店信息查询条件N查询属性中至少有一条查询条件AWARDAWARD酒店等级Y05AWARD字段类型描述默认值可为空备注PROVIDERSTRING评分者YHOTELSTARRATE酒店星级CTRIPSTARRATE携程星级CTRIPRECOMMENDRATE携程评分RATINGDECIMAL分数或级别YHOTELREF字段类型描述默认值可为空备注AREAIDINT区域IDYHOTELCITYCODEINT城市IDYHOTELNAMESTRING酒店名称Y8响应REQUESTRESULTHTTP/IMAGES4CCTRIPCOM/TARGET/HOTEL/19000/18392/27EC273D3C2C4569A345350C5B7E1797_100_75JPG北京西路1068号上海200041HTTP/IMAGES4CCTRIPCOM/TARGET/HOTEL/7000/6698/4A8F09131F494628BB62E1D92A0B362D_100_75JPG余姚路417号上海200042返回酒店信息，包含品牌ID、酒店ID、酒店所在城市ID、酒店名称、行政区ID地理位置信息经度、纬度。酒店地址地址、城市名称、邮编。星级评级者、级别。周边热门地标地理信息改点到酒店距离、距离单位、地标名称。酒店描述等供应商信息酒店短描述和酒店图标URLOTA_HOTELSEARCHRS字段类型描述可为空备注PROPERTIESLIST酒店列表Y酒店信息数组,参见PROPERTYPROPERTY字段类型描述可为空备注CHAINCODEINT连锁集团IDYBRANDCODEINT品牌IDYHOTELCODEINT酒店IDNHOTELCITYCODEINT酒店所在城市IDNHOTELNAMESTRING酒店名称NAREAIDINT行政区IDNPOSITIONPOSITION地理位置信息酒店GPS坐标Y参见POSITIONADDRESSADDRESS酒店地址信息Y参见ADDRESSAWARDAWARD酒店星级、CTRIP星级、用户评级等Y5个并行节点,参见AWARDRELATIVEPOSITIONRELATIVEPOSITION周边热门地标地理信息YVENDORMESSAGESVENDORMESSAGES酒店描述等供应商信息YN个并行节点POSITION字段类型描述可为空备注LATITUDEDECIMAL坐标纬度NLONGITUDEDECIMAL坐标经度NADDRESS字段类型描述可为空备注ADDRESSLINESTRING酒店地址Y05CITYNAMESTRING城市名称NPOSTALCODESTRING邮编YAWARD字段类型描述可为空备注PROVIDERSTRING分数种类Y参见LISTCODEAPCRATINGDECIMAL分值YRELATIVEPOSITION字段类型描述可为空备注DISTANCESTRING和酒店的距离YUNITOFMEASURECODESTRING距离单位YNAMESTRING热点，地标名称YVENDORMESSAGES字段类型描述可为空备注VENDORMESSAGEVENDORMESSAGE酒店短描述和酒店图标URLNVENDORMESSAGE字段类型描述可为空备注INFOTYPESTRING信息类别NSUBSECTIONSUBSECTION属性NSUBSECTION字段类型描述可为空备注PARAGRAPHSTRING属性值N3724酒店静态信息查询OTA_HOTELDESCRIPTIVEINFO1服务地址HTTP/API_URL/HOTEL/OTA_HOTELDESCRIPTIVEINFOASMX2方法名REQUEST3方法参数REQUESTXMLSTRING4功能A根据请求的HOTELCODE返回相应的酒店静态信息，并根据请求返回酒店信息，酒店设施，酒店区域，酒店多媒体信息。5请求示例以下是SOAP11请求和响应示例。所显示的占位符需替换为实际值。POST/HOTEL/OTA_HOTELDESCRIPTIVEINFOASMXHTTP/11CONTENTTYPETEXT/XMLCHARSETUTF8CONTENTLENGTHLENGTHSOAPACTION“HTTP/CTRIPCOM/REQUEST“STRING6响应示例HTTP/11200OKCONTENTTYPETEXT/XMLCHARSETUTF8CONTENTLENGTHLENGTHSTRING7请求REQUESTXMLOTA_HOTELDESCRIPTIVEINFORQ字段类型描述可为空备注HOTELDESCRIPTIVEINFOSLIST酒店详细描述信息请求列表N酒店描述信息数组,最多10个,参见HOTELDESCRIPTIVEINFOHOTELDESCRIPTIVEINFO字段类型描述可为空备注HOTELCODESTRING酒店代码N酒店的唯一地标识代码HOTELINFOHOTELINFO酒店类信息Y参见HOTELINFOFACILITYINFOFACILITYINFO设施类信息（客房、会议室、餐饮、娱乐），这里仅限请求酒店客房设施Y参见FACILITYINFOAREAINFOAREAINFO位置区域类信息Y参见AREAINFOCONTACTINFOCONTACTINFO联系方式类信息Y参见CONTACTINFOMULTIMEDIAOBJECTSMULTIMEDIAOBJECTS多媒体信息Y参见MULTIMEDIAOBJECTSHOTELINFO字段类型描述可为空备注SENDDATABOOL是否发送YTRUE表示需要发送FACILITYINFO字段类型描述可为空备注SENDGUESTROOMSBOOL是否发送客房信息YTRUE表示需要发送AREAINFO字段类型描述可为空备注SENDATTRACTIONSBOOL是否发送景点地标信息YTRUE表示需要发送SENDRECREATIONSBOOL是否发送娱乐区域信息YTRUE表示需要发送CONTACTINFO字段类型描述可为空备注SENDDATABOOL是否发送数据YTRUE表示需要发送MULTIMEDIAOBJECTS字段类型描述可为空备注SENDDATABOOL是否发送数据YTRUE表示需要发送8响应REQUESTRESULT乘坐机场巴士1号线，在雨花台站下车，步行至雨花南路东站，换乘129路，在卡子门西站下车，换乘安铜线，在殷巷站下车，步行约240米。乘坐出租车约63元。乘坐地铁1号线南延线中国药科大学方向，在胜太路站下车，步行至胜太路站，换乘安铜线，在殷巷站下车，步行约200米。乘坐出租车约25元。乘坐地铁1号线南延线中国药科大学方向，在胜太路站下车，步行至胜太路站，换乘安铜线，在殷巷站下车，步行约240米。乘坐出租车约45元。乘坐地铁1号线南延线中国药科大学方向，在胜太路站下车，步行至胜太路站，换乘安铜线，在殷巷站下车，步行约240米。乘坐出租车约58元。HTTP/19216881442227/UPLOAD/HOTEL/19000/18806/80E098FDDE4646F780B49FBC2F71490F_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/AD3E333918184BD29DCE0F073D7CCCD2_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/CF76D20B77504297A952E599CC40CD8A_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/35ABEF01D85741BB81B04DE76E616E89_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/FB29A9DCCAF146149DBA737A9DD549EA_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/C56BF773B253482987F97403684023B7_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/243B1A60232241EF9BC0384D5A8868DB_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/C418E3F1CBBA46718F70B0F333260435_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/3B8985E59ACD4396B7658091C85FECA3_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/D206EB600B1247C5BA8846D4B6040ECB_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/1C7F371C37EC468FA376F5D4970A8BCB_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/20C58C62D9BF47D9BB549D5EAFF37492_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/F8752D7437474916A53E81F23012F112_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/6FD70E6248CB4204BFE452989BAE8BDB_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/1E526A22AF8A4C41B7362858AA8DD196_550_412JPGHTTP/19216881442227/UPLOAD/HOTEL/19000/18806/9846945B7A314771A531E9F32758A12B_550_412JPG南京湖滨金陵饭店座落在风光秀丽的百家湖畔东北面的半岛上，三面环湖，与湖光山色相映成趣，融为一体，美仑美奂。分布于建筑物间的亲水休闲花园和庭园后部的垂钓休闲区更为饭店营造了一种人与自然和谐的气氛。地铁一号南延线于2010年中旬正式开通，胜太路站站距湖滨金陵饭店步行仅5分钟路程。南京湖滨金陵饭店座落在风光秀丽的百家湖畔东北面的半岛上，三面环湖，与湖光山色相映成趣，融为一体，美仑美奂。分布于建筑物间的亲水休闲花园和庭园后部的垂钓休闲区更为饭店营造了一种人与自然和谐的气氛。HTTP/HOTELSCTRIPCOM/HOTEL/18806HTML1酒店环境和房间还算不错,早餐也很好BR/2环境和服务都比较满意，客房用餐的响应速度较快，质量也不错OTA_HOTELDESCRIPTIVEINFORSHOTELDESCRIPTIVECONTENTS字段类型描述可为空备注HOTELDESCRIPTIVECONTENTSLIST酒店详细描述类信息内容列表Y参见HOTELDESCRIPTIVECONTENT；1HOTELDESCRIPTIVECONTENT字段类型描述可为空备注BRANDCODESTRING酒店品牌代码YHOTELCODESTRING酒店代码NHOTELCITYCODESTRING酒店所在城市代码NHOTELNAMESTRING酒店名称NAREAIDSTRING行政区代码NHOTELINFOHOTELINFO酒店类信息Y参见HOTELINFO,01FACILITYINFOFACILITYINFO设施信息Y参见FACILITYINFO,01AREAINFOAREAINFO行政区信息Y参见AREAINFO,01MULTIMEDIADESCRIPTIONSMULTIMEDIADESCRIPTIONSY01AFFILIATIONINFOAFFILIATIONINFO酒店星级、携程星级、推荐级别YHOTELINFO字段类型描述可为空备注WHENBUILTDATETIME何时建造YLASTUPDATEDDATETIME酒店信息上次更新时间（时间戳）YHOTELSTATUSCODESTRING酒店状态NCATEGORYCODESCATEGORYCODES一些常用的酒店标签和分类Y参见CATEGORYCODESSERVICESSERVICES酒店服务和设备列表Y参见SERVICEPOSITIONPOSITION地理位置经纬度Y参见POSITIONCATEGORYCODES字段类型描述可为空备注SEGMENTCATEGORYLIST定义酒店等级特点，比如豪华型，经济型等Y参见SEGMENTCATEGORY；0SEGMENTCATEGORY字段类型描述可为空备注CODESTRING段分类IDY参考CODELISTSEGSERVICES字段类型描述可为空备注SERVICELISTN参见SERVICESERVICE字段类型描述可为空备注CODESTRING设施设备代码Y参考CODELISTHACIDSTRING设施设备类别，例如客房设施和服务、宾馆餐饮设施等。YDESCRIPTIVETEXTSTRING文字描述YPOSITION字段类型描述可为空备注LONGITUDESTRING经度YLATITUDESTRING纬度YFACILITYINFO字段类型描述可为空备注GUESTROOMSGUESTROOMS房型信息YGUESTROOMS字段类型描述可为空备注GUESTROOMLISTY参见GUESTROOMGUESTROOM字段类型描述可为空备注ROOMTYPENAMESTRING房型名称NAMENITIESAMENITIES设施设备Y参见AMENITYFEATURESFEATURES特点Y参见FEATUREDESCRIPTIVETEXTSTRING描述类文字YTYPEROOMLIST客房属性Y参见TYPEROOM；05TYPEROOM字段类型描述可为空备注STANDARDOCCUPANCYSTRING标准入住人数NSIZESTRING床的尺寸YROOMGROUPROOMGROUPY参见ROOMGROUPROOMGROUP字段类型描述可为空备注ROOMTYPECODESTRING房型代码N对应CTRIP基础房型FLOORSTRING客房在建筑的第几层YBEDTYPECODESTRING床型代码Y参考CODELISTBEDQUANTITYSTRING房间数量YAMENITIES字段类型描述可为空备注AMENITYLIST房间设施Y是否可加床、免费宽带、付费宽带。参见AMENITY；1AMENITY字段类型描述可为空备注ROOMAMENITYCODESTRING房间设施代码Y参考CODELISTRMADESCRIPTIVETEXTSTRING描述性文字YFEATURES字段类型描述可为空备注FEATURELIST客房特点等信息外宾专用等N参见FEATURE；1FEATURE字段类型描述可为空备注DESCRIPTIVETEXTSTRING描述性文字YAREAINFO字段类型描述可为空备注REFPOINTSREFPOINTS地标类区域和建筑Y参见REFPOINTREFPOINTS字段类型描述可为空备注REFPOINTSLIST区标参见REFPOINT；1REFPOINT字段类型描述可为空备注DISTANCESTRING距离数YUNITOFMEASURECODESTRING距离单位YNAMESTRING地标名称Y如浦东机场REFPOINTCATEGORYCODESTRING地标类别代码Y参考CODELISTREFREFPOINTNAMESTRING参考点名称YPOSITIONGROUPPOSITIONGROUP参见POSITIONGROUPDESCRIPTIVETEXTSTRING文字描述POSITIONGROUP字段类型描述可为空备注LATITUDESTRING纬度YLONGITUDESTRING经度YMULTIMEDIADESCRIPTIONS字段类型描述可为空备注MULTIMEDIADESCRIPTIONLIST多媒体类信息Y参见MULTIMEDIADESCRIPTION；1MULTIMEDI