河北省文旅分时预约管理服务平台
接口对接指南
一、基本资料采集
(一)景区需完成基本资料采集表的填写(详见基础资料采集表)。
(二)景区需提供一张以带有景区名称的标识性图片,清晰、美观,格式为“xxx.jpg”。
(三)其他线下流程可根据景区预约预订引导完成。
二、景区现有预约预订系统数据对接
(一)景区已自有预约预订系统,可通过“河北省文旅分时预约管理服务平台”提供的标准接口将预约数据、剩余预约数和当日限流量推送至平台。数据逻辑应遵循:当日限流量=预约数+剩余预约数。
(二)没有自建预约预订系统的景区,可统一使用“河北省文旅分时预约管理服务平台”的景区管理端和游客端,实现游客分时预约预订生成预约二维码及扫码入园;景区管理人员对预约预订二维码进行扫码核销。
(三)对开放式景区及旅游聚集地,推荐使用“河北省文旅分时预约预订管理服务平台”进行线上预约、线下扫码核验管理。
三、有关河北健康码数据对接
(一)“河北省文旅分时预约管理服务平台”将与“河北健康码”实现数据对接。
(二)游客通过“河北省分时预约管理服务平台”系统预约成功,持预约生成的二维码扫码入园,由景区管理人员进行扫码核销时,系统将调用游客河北健康码信息,并提示是否符合入园条件。游客通过OTA、其他票务分销系统预约预订成功生成的二维码,需再单独扫描河北健康码,以确认是否合格。
四、预约数据对接标准
(一)预约数据对接标准
(二)基础资料采集表
预约数据对接标准
一、预约数据对接标准接口(二次开发)
(一)接口安全访问控制
接口请求头部须携带认证Token
认证信息:APPID:wx916a82e175a27623
APPSecret:96dfaac9ff3d5a7f6e86e3ae5d765a5c
(二)接口请求说明
采用HTTP/HTTPS为应用层传输协议
请求方式统一为POST
Http请求头ContentType为application/json
统一采用UTF-8编码
(三)返回数据格式统一如下:
名称 |
类型 |
说明 |
errorCode |
string |
“00000”为成功编码,其他为请求失败 |
message |
string |
错误信息 |
data |
object或array |
返回数据 |
*注: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值:为《基础资料采集表》中“可提前预售周期”的数值)。每日数据包含:预约数据、剩余预约数和当日限流量。数据逻辑应遵循:当日限流量=预约数+剩余预约数。
基础资料采集表
*景区名称 |
xxxx |
||
*场馆等级 |
|
*景区地址 |
xx省xx市xx区/县xxxxxxxxxx |
*是否有票务系统 |
|
*是否付费预约 |
|
*景区服务电话 |
xxx |
*可提前预售周期 |
xx天 |
*微信公众号APPID |
获取方式:查看分表《附件1-如何获取开发者ID》 |
*每日预约上限 |
xx人 |
*公众号联系人电话 |
|
景区经纬度 |
|
开放时间 |
举例:10:00-16:00,每周一闭馆,疫情期间开放时间为10:00至16:00 |
个性标签 |
标签举例:查看分表《附件2-个性标签示例》 |
公众号地址 |
网址+二维码 |
官网地址 |
www.xxx |
*产品种类1 |
xx票、xx元 |
产品种类2 |
xx票、xx元 |
产品种类3 |
... |
|
|
*预约时段1 |
时间段、人数 |
预约时段2 |
时间段、人数 |
预约时段3 |
... |
|
|
*预约须知信息 |
举例: |
||
*景区介绍 |
xxxx |
上一篇: 中华人民共和国反间谍法
下一篇: 导游管理办法