河北省文旅分时预约管理服务平台

接口对接指南

一、基本资料采集

（一）景区需完成基本资料采集表的填写（详见基础资料采集表）。

（二）景区需提供一张以带有景区名称的标识性图片，清晰、美观，格式为“xxx.jpg”。

（三）其他线下流程可根据景区预约预订引导完成。

二、景区现有预约预订系统数据对接

（一）景区已自有预约预订系统，可通过“河北省文旅分时预约管理服务平台”提供的标准接口将预约数据、剩余预约数和当日限流量推送至平台。数据逻辑应遵循：当日限流量=预约数+剩余预约数。

（二）没有自建预约预订系统的景区，可统一使用“河北省文旅分时预约管理服务平台”的景区管理端和游客端，实现游客分时预约预订生成预约二维码及扫码入园；景区管理人员对预约预订二维码进行扫码核销。

（三）对开放式景区及旅游聚集地，推荐使用“河北省文旅分时预约预订管理服务平台”进行线上预约、线下扫码核验管理。

三、有关河北健康码数据对接

（一）“河北省文旅分时预约管理服务平台”将与“河北健康码”实现数据对接。

（二）游客通过“河北省分时预约管理服务平台”系统预约成功，持预约生成的二维码扫码入园，由景区管理人员进行扫码核销时，系统将调用游客河北健康码信息，并提示是否符合入园条件。游客通过OTA、其他票务分销系统预约预订成功生成的二维码，需再单独扫描河北健康码，以确认是否合格。

四、预约数据对接标准

（一）预约数据对接标准

（二）基础资料采集表

预约数据对接标准

一、预约数据对接标准接口（二次开发）

（一）接口安全访问控制

接口请求头部须携带认证Token

认证信息：APPID：wx916a82e175a27623

APPSecret：96dfaac9ff3d5a7f6e86e3ae5d765a5c

（二）接口请求说明

采用HTTP/HTTPS为应用层传输协议

请求方式统一为POST

Http请求头ContentType为application/json

统一采用UTF-8编码

（三）返回数据格式统一如下：

*注：1.单个数据推送

参数以表单格式提交(加密校验body传空字符串)

接口：

http://bdata.hebeitour.com.cn/api/res/api/external/noticeOrderStock

2.批量数据推送

参数以JSON格式放入body提交(加密校验body即为实际JSON字符串)

接口：

http://bdata.hebeitour.com.cn/api/res/api/external/multiNoticeOrderStock

二、分时预约预订数据对接要求

（一）微信小程序数据对接方式

景区已有微信小程序或公众号实现游客分时预约管理的，填写资料采集表（见基础资料采集表）。

  （二）景区自有票务系统或依托第三方OTA平台实现游客分时预约管理的数据对接方式

景区自有票务系统或依托第三方OTA平台（如美团、携程、途牛等）实现游客分时预约管理的,通过“预约预订标准接口”进行数据推送，将预约预订相关数据按1次/10分钟推送，推送的数据为近N天的所有预约数据（N值：为《基础资料采集表》中“可提前预售周期”的数值）。每日数据包含：预约数据、剩余预约数和当日限流量。数据逻辑应遵循：当日限流量=预约数+剩余预约数。

基础资料采集表

相关链接：关于做好全市文旅分时预约管理服务平台数据接入工作的通知