酒店API对接
RateHawk API对接：从API密钥到正式酒店预订
将您的RateHawk账户接入PHPTRAVELS，在自己的网站和代理商门户上销售RateHawk的酒店和公寓。连接器已经就绪：填写API密钥，导入酒店数据库，设置加价，然后完成RateHawk的认证。
- 现成的RateHawk连接器
- ETG API v3
- 酒店数据包导入
- 在净价上设置您的加价
供应商
RateHawk是什么，旅行社为什么要对接它
RateHawk是Emerging Travel Group（ETG）旗下面向旅行代理、旅游运营商和旅游企业的B2B预订平台。合作伙伴可以通过RateHawk自己的门户或其API，以净价预订酒店、公寓和其他住宿。
该API名为ETG API，当前版本为v3，是一个使用JSON请求和响应的REST API，涵盖搜索、预订和取消。PHPTRAVELS在住宿模块中内置了RateHawk连接器，RateHawk的结果会与您的其他酒店供应商和自有合同房源一起显示。
- 公司
- RateHawk，隶属于Emerging Travel Group
- 类型
- 面向旅游从业者的B2B住宿平台
- 库存
- 据RateHawk称，超过260万个住宿选择
- API合作伙伴
- 据RateHawk 2024年称，超过700家API客户
- API
- ETG API v3 · REST · JSON
- 在PHPTRAVELS中
- 住宿模块中的现成连接器
ETG API v3预订流程
一笔RateHawk预订如何逐阶段完成
每一笔RateHawk预订都经过相同的五个阶段。每个阶段都列出了背后的ETG API调用，以及PHPTRAVELS为您完成的工作。
- 01
搜索
ETG API调用
按区域 · 按地理坐标 · 按酒店ID搜索
PHPTRAVELS
按城市、地图区域或酒店列表搜索，带上日期、客人数和旅客的居住国，并显示加上您加价后的实时净价。
- 02
酒店页面
ETG API调用
获取酒店页面
PHPTRAVELS
加载所选酒店的全部房型和价格：餐食、税费、取消政策和付款方式。
- 03
预预订
ETG API调用
预预订价格 · 获取价格信息
PHPTRAVELS
在付款前一刻确认所选价格仍可按该价格预订，如价格有变则中止结账。
- 04
预订
ETG API调用
创建、启动并检查预订流程
PHPTRAVELS
创建预订，发送客人信息，跟踪状态直至确认，并保存RateHawk订单ID。
- 05
预订之后
ETG API调用
获取预订 · 取消预订 · 状态webhook
PHPTRAVELS
发送确认单，在后台和客户账户中显示预订，并按该价格的政策处理取消。
静态数据
一次导入RateHawk酒店数据库，之后保持更新
搜索结果只包含价格。酒店名称、地址、照片、设施和介绍来自ETG的静态数据，PHPTRAVELS会将其导入您的酒店页面。
区域数据包
国家、城市和区域，方便旅客按目的地搜索。
酒店数据包
完整的酒店内容文件：名称、地址、坐标、照片、设施和介绍。
增量数据包
只包含自上次导入以来的变更，无需全量重新加载即可让目录保持最新。
点评数据包
在酒店页面上展示的住客点评评分和内容，前提是您的协议包含此项。
- 区域数据包100%
- 酒店数据包100%
- 增量数据包64%
- 点评数据包30%
示例界面。数量取决于您的账户和语言。
除数据包文件外，ETG还提供按需获取酒店数据的Content API。
API密钥与测试环境
RateHawk API认证的工作方式
ETG API使用HTTP Basic认证。您的密钥ID作为用户名，API密钥作为密码，每次请求都通过HTTPS发送。
1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3 -H "Content-Type: application/json" \ 4 https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5 -d '{ 6 "checkin": "2026-11-14", 7 "checkout": "2026-11-16", 8 "residency": "gb", 9 "language": "en",10 "currency": "USD",11 "guests": [{ "adults": 2, "children": [] }],12 "hids": [8473727]13 }'1415# 8473727 = the test hotel: a real booking if you book it
- 两个主机
- 测试环境：api-sandbox.ratehawk.com。测试和正式环境：api.ratehawk.com。旧的worldota.net主机已弃用。
- 测试酒店是真实的
- 测试密钥只能预订hid 8473727的测试酒店，而该预订是真实的，需承担真实的财务责任。测试后请立即取消。
- 密钥只保存在服务器上
- PHPTRAVELS将密钥ID和API密钥保存在服务器配置中，绝不放在浏览器或应用中。
- 居住国很重要
- 价格取决于旅客的居住国，因此连接器会在每次搜索时一并发送。
在PHPTRAVELS中配置
四步配置RateHawk连接器
无需编写代码：连接器在后台管理面板中配置。
- 01填写API密钥粘贴RateHawk提供的密钥ID和API密钥，先用于测试环境，之后用于正式环境。
- 02导入酒店数据库加载区域和酒店数据包，然后安排增量更新。
- 03设置加价和币种按渠道、代理商分组或目的地设置百分比或固定加价，使用您销售的币种。
- 04测试并上线完成测试预订和取消，通过认证，然后切换为正式环境密钥。
环境
https://api-sandbox.ratehawk.comhttps://api.ratehawk.com
示例设置界面。
认证
从签署协议到获得正式环境权限
只有在协议签署且您的对接通过认证后，RateHawk才会开放正式环境。
- 1
签署API协议
您以旅游企业身份联系RateHawk，签署适用于您所在市场的API协议。
- 2
获取测试环境密钥
RateHawkRateHawk为测试环境发放密钥ID和API密钥。
- 3
连接并导入
PHPTRAVELS将密钥填入PHPTRAVELS，导入静态数据并设置加价。
- 4
通过认证
RateHawkRateHawk检查对接情况，包括预订、状态和取消流程。
- 5
正式环境权限
您将正式环境密钥填入后台，开始接收真实预订。
门户、API还是预订引擎
销售RateHawk酒店的三种方式
代理现在就可以在RateHawk自己的网站上预订。而接入您自有预订引擎的API，才能让RateHawk酒店以您的品牌销售。
RateHawk网站
- 谁来预订
- 您的代理，一次一笔预订
- 谁的品牌
- RateHawk
- 需要做什么
- 注册为代理并登录
自行开发API对接
- 谁来预订
- 您的客户和代理，在线预订
- 谁的品牌
- 您的品牌
- 需要做什么
- 数月的开发和认证
PHPTRAVELS + RateHawk
- 谁来预订
- 您的客户和代理，在线预订
- 谁的品牌
- 您的品牌
- 需要做什么
- 配置、内容导入和认证
RateHawk没有公布API访问费用。您签署API协议后，以净价加上自己的加价销售其酒店。您的成本是预订软件、主机托管和支付费用。
以旅游企业身份联系RateHawk并签署API协议。随后RateHawk会发放测试环境的密钥ID和API密钥，认证通过后再发放正式环境密钥。
ETG API文档在线发布于docs.emergingtravel.com，包括B2B API、Content API、测试环境和认证指南。没有单独的PDF可供下载，在线文档即为最新版本。
ETG API是RateHawk背后的公司Emerging Travel Group的API。RateHawk API对接和ETG API对接指的是同一件事，当前版本为v3。
PHPTRAVELS是一次性授权，起价US$2,499，包含完整源代码，RateHawk连接器已包含在住宿模块中。您与RateHawk之间的商务条款由您与RateHawk商定。
有，地址为api-sandbox.ratehawk.com。请注意，测试密钥只能预订hid 8473727的测试酒店，而该预订是真实的，因此测试后请立即取消。
代理需在ratehawk.com注册并登录，才能在门户中预订。API访问是分开的：它使用协议中的密钥ID和API密钥，而不是您的门户登录信息。
连接器已经存在，因此时间主要花在签署协议、填写密钥、导入酒店内容和RateHawk认证上，而不是开发。
可以。同一个连接器同时服务您的B2C网站和B2B代理商门户，并可按渠道和代理商分组分别设置加价。
每个价格都带有自己的取消政策，并在付款前显示。取消可在后台或客户账户中发起，通过取消预订调用按该政策执行。