概览

更新时间：2022-05-19

1、主要流程

目前与百度酒店合作的模式主要分为两种，

1. 自营模式，由百度提供填单、支付、订单全流程服务，商户及酒店PMS接收预定信息和支付结果通知，完成售后系列服务
2. 联运模式，百度负责商品、订单数据的呈现，由商户完成填单、支付、订单回传的功能实现以及售后服务

图片1.png

2、技术交互

2.1、推送

2.1.1、推送频率

1. 酒店基础数据确保每天至少一次全量推送
2. 房态、房价、库存等变更数据，即时变化即时推送变化量
3. 根据2)的变化量主动查询合作方变动数据
4. 推送峰值应<100qps，例：40w酒店最低在2h内推送完成，天级全量酒店列表推送 应避开 房型、房态、房价变更推送高峰期，建议每天凌晨3:00-5:00发起

涉及接口：酒店基础|商户->百度、酒店房型变动通知|商户->百度

2.1.2、统一数据推送地址

* 测试地址：https://maphotel.baidu.com/map_mc/mc/tpnotify?topic=e569f262b2a345588af22b13b5892565__test_tp_notify
* 正式地址：待分配
* 推送方式：HTTP POST，将推送数据打包成JSON格式，写入到HTTP地址。
* 重试：3
* 超时设置：5s

参数表

字段名	类型	必填	释义
content	json	Y	站点数据集
公共参数	-	Y	参考公共参数部分

推送成功返回

{
    "errno": 0,
    "errstr": "",
    "desc": "",
    "data": {
    }
}

2.2、数据抓取

* 百度天级抓取全量的房型房价数据
* 百度根据商户推送的变更信号量，即时抓取动态信息，包括房态、房价、优惠信息等
接口平响<1000ms
涉及接口：酒店物理房型查询|百度->商户、酒店房型房价查询百度->商户

2.3、请求

百度向商户、或商户向百度 发起请求，接口平响<500ms

涉及接口：酒店试单|百度->商户、自营填单|百度->商户、发票回传|百度->商户、订单状态变更回传|商户->百度、订单取消|百度->商户

2.4、通知

百度处理支付、退款过程处理完成后，按固定通知策略请求商户指定接口。
接口平响<1.5s（超过1.5s触发超时重试），重试策略：1次/2分钟，累计次数200次。
涉及接口： 支付结果通知、退款结果通知

3、公共参数

为确保对内外请求安全性，添加公共参数并对公共参数进行统一验签，对于百度请求商户、商户请求百度的所有请求，在请求参数中添加以下公共参数，对于商户数据推送百度，在推送json数据体最外层key中也添加以下公共参数（详细见各推送数据样例和各接口请求参数表示例）。

	字段名	类型	长度	必填	释义
1	tp_name	string	64	Y	渠道号，开发前分配渠道号和私钥（primary_key），请妥善保管
2	timestamp	int	-	Y	时间戳
3	salt	string	64	Y	随机串
4	sign	string	64	Y	签名，签名规则 md5(tp_name + timestamp + salt + primary_key)，参数值（不含参数名）拼接

sign参数示例

tp_name=baidu
timestamp=1648884086
salt=8h9nja
primary_key=42b9e6848ee3da027310384c770fceb8

sign=md5("baidu16488840868h9nja42b9e6848ee3da027310384c770fceb8")=4a92801b7131fc5cb0ea5d46d3c89a41

4、交互时序

图片2.jpg

5、特殊标识

文档标题的百度->商户：表示百度请求商户；商户->百度：表示商户请求百度