携程网站联盟api平台

《携程网站联盟api平台》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、携程网站联盟API平台集成开发指南文件状态：[]草稿[]正在修改[√]正式发布文档编号：项目名：网站联盟II期-API平台作者：刘磊文件名：携程旅行网网站联盟API接入文档.doc保密等级：审核人：批准人：最后更新时间：2012-4-20版权申明：本文件属于机密文件，所有权属于携程计算机技术（上海）有限公司。任何接触此件的人必须遵守以下规定：1．本文件及包含的内容均属于携程计算机技术（上海）有限公司资产。2．未经携程计算机技术（上海）有限公司的书面同意，任何人不得对本文件的全部和/或部分内容进行任何形式的复制或传播扩散。版本历史版本/状态作者审核人发布日期备注V1.0刘

2、磊2012-3-5V1.1刘磊2012-3-15更新API使用手册规范错误编号V1.2刘磊2012-3-26增加国内机票API使用手册增加支付API使用手册V1.3刘磊2012-4-20修改时间戳为1970年起增加支付API使用手册目录1.引言41.1.目的41.2.读者对象41.3.文档内部约定41.3.1.文档字体约定41.4.参考文档41.5.术语与缩写52.方案概述62.1.业务说明62.2.业务流程72.3.接口介绍93.交互模式93.1.后台调用交互模式94.数据格式94.1.GET或POST94.2.请求地址94.3.请求频次104.4.字符串格式104.

3、5.签名原始串114.6.签名算法114.6.1.MD5签名114.6.2.MD5签名原理125.附录125.1.FAQ125.1.1.问：我运行程序后怎么一直报错误代码：签名错误？125.1.2.问：我怎么得到联盟身份（Alliance）和站点密钥（Secretkey）？121.引言1.1.目的本文描述了网站联盟API平台对联盟伙伴提供的接口化预订解决方案，帮助联盟伙伴轻松实现酒店、机票、度假等在线旅游业务查询、预订、API功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了API平台的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作

4、为日后接口参数及参数类型的速查手册。1.2.读者对象本文档的预期读者为业务需求人员、开发经理、项目经理、架构设计师、开发人员、测试人员、设计评审人员、用户文档编写者。1.3.文档内部约定1.3.1.文档字体约定▲着重说明字体：对于本文中重要，易混淆，易疏忽的关键内容进行标记时使用的字体▲补充说明字体：为便于读者理解，文本在某些描述之后会使用现有系统的实际情况举例，这是一种对于前文进行补充说明时使用的字体▲待定信息字体：对于本文在编写时未确定，需与相关干系人进一步明确信息时使用的字体1.4.术语与缩写术语/缩写解释APIApplicationProgrammingInte

5、rface应用程序接口本文中指携程旅行网提供给联盟伙伴的业务数据接口AllianceID联盟ID指联盟伙伴通过网站联盟平台(http://u.ctrip.com)自行注册或通过携程客户经理注册后得到的唯一联盟标识类型为Int32SID站点ID指联盟伙伴通过网站联盟平台(http://u.ctrip.com)开通联盟并登录后自行添加或通过携程客户经理注册后得到的联盟下站点的唯一标识类型为Int32。一个联盟可拥有多个站点SecretKey密钥指联盟伙伴通过携程客户经理完成API平台权限开通后获得的针对每个SID的唯一身份认证标识。可通过登录联盟平台(http://u.ct

6、rip.com)后通过站点列表中的站点详情页查看。请妥善保存此密钥并不得泄露给第三方TimeStamp时间戳本文中指以1970-1-100:00:00.000为基准，至当前时间为止的总秒数Signature签名以TimeStamp、SID、MD5(SecretKey)按照顺序字符串拼接后MD5加密所得的字符串。MD5相关请见MD5签名章节1.方案概述1.1.业务说明API平台提供联盟伙伴自行通过携程旅行网提供的在线旅游业务API实现业务相关流程，避免了只能导流量而不能自主定义预订流程的问题1.1.业务流程1.1.接口介绍Ø携程旅行网网站联盟API使用手册-酒店Ø携程旅行

7、网网站联盟API使用手册-国内机票Ø携程旅行网网站联盟API使用手册-支付2.交互模式2.1.后台调用交互模式后台系统调用交互模式是指联盟站点向API平台系统发送请求数据，并同步等待API平台系统处理完毕后返回的响应数据。数据交互是商户服务器与API平台服务器直接通信，请求采用携程SOAWebService服务，请求和应答都采用xml数据格式。如用户在查询酒店时，联盟站点要根据用户输入的搜索条件获取酒店列表，可以在服务器上发送一个查询请求，API平台收到请求后把查询结果以xml格式返回给商户，联盟站点处理结果后再显示给用户。3.数据格式3