网站对接规范Word格式.docx
- 文档编号:5753417
- 上传时间:2023-05-05
- 格式:DOCX
- 页数:46
- 大小:31.38KB
网站对接规范Word格式.docx
《网站对接规范Word格式.docx》由会员分享,可在线阅读,更多相关《网站对接规范Word格式.docx(46页珍藏版)》请在冰点文库上搜索。
用户注册账户密码
◆合作网站返回的处理结果数据的规格如下:
status
整型
1:
处理成功,0值表示处理不成功
msg
提示信息
data
(对象类型)
数据结果(可以为空)
备注补充:
◆合作网站预先提供关于本网站用户注册的规则信息,例如:
用户名长度要求、用户名是否可以包含空格和汉字、密码最低长度要求等
2.2用户登录
◆新店家用户使用合作网站的账号,通过房管通系统提供的登录功能,登录到合作网站上(后续操作,店家用户将通过使用该登录账号,维护其在合作网站上的房态、房价、房源等信息)
◆该业务要求房管通向合作网站推送用户登录的信息,合作网站根据房管通提供的用户登录信息返回该店家用登录的处理结果
用户账户名
用户账户密码
◆
2.3用户信息
◆店家用户在房管通维护其用户信息(包括基本信息、详细信息、账户信息等)
◆该业务要求房管通向合作网站推送店家用户信息(包括新增和更新),房管通向合作网站推送店家用户的资料信息
◆合作网站根据其数据需求,解析和保存用户信息,并返回处理结果
合作网站上的用户登录名
user_nickname
昵称
user_surname
姓氏
user_name
名
user_gender
性别。
0:
女,1:
男
user_cellphone
手机号码
user_cellphone_for_message
用户接收短信的手机号码
user_tele_area
电话区号
user_telephone
座机号码(如无座机,则可以是手机号码)
user_ext_telephone
座机分机号
user_fax_area
传真区号
user_fax
传真号码
user_email
电子邮箱
user_qq
用户QQ号码
user_msn
用户MSN
user_picture
用户头像图片网址链接
user_birth_year
出生年份
user_birth_month
出生月份
user_birth_day
出生日期
user_school
用户毕业院校
user_province
用户所在省
user_city
用户所在市
user_address
用户住址
user_add_phone1
备用电话1
user_add_phone2
备用电话2
user_license
店家营业执照号码
user_license_picture
店家营业执照扫描图片网址链接
user_idnumber
身份证号码
user_idcard_picture
身份证扫描图片网址链接
user_selfdescription
自我介绍
user_finance_name
酒店财务联系人
user_finance_telephone
酒店财务联系人手机
user_finance_mail
酒店财务联系人邮箱
user_accountlist
(集合)
用户设置的结算账户列表(允许多个账户)。
每一个结算账户的数据规格见下表。
⏹结算账户的数据规格如下:
account_state
若用户有多个结算账户,则该参数标识是否为默认账户:
0否,1是。
若只有一个结算账户,则该账户为默认账户,取值1。
account_type
账户类型:
1:
支付宝,2:
财付通,3:
银行账户
account_num
账户账号
account_name
账户姓名
bank_name
开户行银行名称。
非银行账户该参数为空
bank_province
开户行所在省。
bank_city
开户行所在市。
bank_subbranch
开户行所属支行。
bank_type
银行账户类型:
0个人账户,1企业账户。
◆对于用户信息,上述数据规范提供了基础参考。
若合作网站对信息内容有特殊要求可以另行提出,例如:
对于某些信息,合作网站要求用户必填或某些信息的字符长度最大或者最小限制。
对于特殊数据规格的要求,合作双方另行协商约定在哪一方控制和处理。
2.4酒店信息
◆店家用户在房管通系统维护其在房管通上的酒店信息
◆该业务要求房管通向合作网站推送店家的酒店信息(包括新增和更新)
◆合作网站根据其数据需求,解析和保存该用户的酒店信息,并返回处理结果
hotel_id
合作网站该酒店ID。
房管通首次推送时该ID为空,合作网站上根据推送信息新增该酒店信息时,需要将ID包含在返回结果中;
后续房管通更新酒店信息并推送至合作网站是提供该ID。
hotel_name
酒店名称
hotel_type1
酒店类别(文字描述,需要双方协商类别名称规范,房管通提供的参考规范详见备注)
hotel_type2
酒店子类别(文字描述,需要双方协商类别名称规范,房管通提供的参考规范详见备注)
hotel_telephone_area
前台号码区号
hotel_telephone
前台号码
hotel_introduction
酒店简介
hotel_setup_year
开业年份
hotel_decorate_year
装修年份
hotel_announcement
一句话广告
hotel_tags
特色标签。
多个标签时采用CSV格式表示,
例如:
“古色古香,田园风光,古镇风情”
hotel_province
所在省
hotel_city
所在市
hotel_region
所在区
hotel_biotope
小区/地名
hotel_address
详细地址
hotel_longitude
数值型
地图经度
hotel_dimension
地图纬度
hotel_awayfrom_airport
与机场的距离(公里)
hotel_airport_traffic
到机场的交通信息描述
hotel_awayfrom_train
离火车站距离(公里)
hotel_train_traffic
到火车站的交通信息描述
hotel_awayfrom_bus
离汽车站的距离(公里)
hotel_bus_traffic
到汽车站的交通信息描述
hotel_awayfrom_wharf
到离码头的距离(公里)
hotel_wharf_traffic
到码头的交通信息描述
hotel_other_traffic
其他交通信息描述
hotel_landmark
附近地标。
多个地标以CSV格式表示,
“杭州六公园,杭州城战火车站,南山路”
hotel_scenicspot_and_tradingarea
景点/商区。
多个景点/商区以CSV格式表示,例如:
“西湖景区,柳浪闻莺,河坊街,武林商业街”
hotel_surrounding_service
周边配套服务。
多个配套服务以CSV格式表示,例如:
“公交车站,西湖码头,花鸟市场,吴山美食街”
hotel_facility_service
酒店设施服务包含多个服务项目,以嵌套对象类型的形式描述。
详见下文关于该对象数据规格的说明。
hotel_other_service
其它服务说明
hotel_invoice
是否可开发票,-1不提供,0免费,>
0,收费(%)
hotel_foreign_guests
是否接待外宾,1接待,0不接待
hotel_need_identity_card
入住是否需要身份证。
1需要,0不需要
hotel_checkin_time
入住时间(取0至24之间的整数,24小时制)
hotel_checkout_time
退房时间(取0至24之间的整数,24小时制)
hotel_save_time
最晚保留时间(取0至24之间的整数,24小时制)
hotel_business_hours_begin
营业开始时间(例如:
6点;
取0至24之间的整数,24小时制)
hotel_business_hours_end
营业结束时间(例如:
22点;
hotel_can_swiping
是否可以刷卡:
1可以0不可以
hotel_credit_card_support
支持的信用卡种类。
多个种类以CSV格式表示,例如:
“国内银联卡,国际信用卡万事达(Master),国际信用卡威士(VISA)”
hotel_other_require
其它要求
hotel_other_declare
其它补充说明
hotel_picturelist
(集合类型)
酒店图片集。
同一家酒店可以有多条酒店图片信息。
每一条酒店图片信息的数据规格如下表所述。
⏹酒店图片信息的数据规格如下:
hotelinfo_picture_type
图片类别:
外观;
2:
大厅;
3:
公共区域;
4:
周边环境;
5:
餐厅;
6:
娱乐设施;
7:
客栈印象图片;
8:
其它
hotelinfo_picture_path
图片的网址链接
hotelinfo_picture_describe
图片描述
⏹酒店设施服务的项目描述,数据规格如下:
kongtiao
空调。
-1不提供,1提供
nuanqi
暖气。
wifi
免费wifi。
kuandai
宽带上网。
空字符串表示不提供,非空字符串时取字符串字面含义。
非空字符串的枚举值有:
免费、收费、无、不确定、部分收费、部分房间有且免费、部分房间有且收费、部分房间有且部分免费。
reshui
24小时热水。
wzaiss
无障碍设施。
djjmj
对讲机门禁。
beidangh
被单更换。
空字符串表示不提供,非空字符串按字面意义解释,枚举值包括:
每日一更、每客一更、每周一更。
dzks
电子卡锁。
dianti
电梯。
baoan
保安。
swzx
商务中心。
yhkxyk
接受银行卡/信用卡。
-1不支持,1支持
hyzx
会议中心。
tingchewei
停车位。
-1不提供,非负数值表示停车计费(计费单位:
元/天)
czdy
传真打印。
jxfw
叫醒服务。
zsct
中式餐厅。
xsct
西式餐厅。
zzcf
自助厨房。
zzsk
自助烧烤。
mfpc
免费品茶。
mfcs
免费茶水。
mfsg
免费水果。
mflyzx
免费旅游咨询。
zxczl
自行车租赁。
bczcfw
包车/租车服务。
dyfw
导游服务。
-1不提供,非负数值表示导游计费(计费单位:
dsmp
代售门票。
dscp
代售车票。
djmxp
代寄明信片。
jzfw
接站服务。
-1不提供,非负数值表示服务计费(计费单位:
元/次)
xxq
休闲区。
gpkl
光盘刻录。
ddtc
代售当地特产。
jjfw
接机服务。
xljc
行李寄存。
cyyp
提供常用药品。
xhkh
小孩看护。
jdjtxh
可接待家庭/小孩。
-1不接待,1可接待
chaoshi
超市。
-1没有,1有
kdcw
可带宠物。
-1不允许,1允许
xiyan
可以吸烟。
xyffw
洗衣房/服务。
zzxy
自助洗衣。
yinghan
银行。
hxjg
海鲜加工。
wangba
网吧。
minidyy
迷你电影院。
sgcz
水果采摘。
jianshefang
健身房。
字符串为空表示不提供;
字符串非空则按照“[单价],[计价单位]”格式提供,例如:
“30,小时”表示30元一小时,“90,次”表示90元入场一次。
jiuba
酒吧。
qipai
棋牌。
zhuoyou
桌游。
zdmjz
自动麻将桌。
mfskyd
免费书刊阅读。
dyyl
电影阅览。
chuidiao
垂钓。
jbhd
是否适合举办活动。
空字符串表示不适合;
“900,天”表示900元一天,“1500,次”表示1500元举办一次。
sanna
桑拿。
wenquan
温泉。
spa
SPA。
snyyc
室内游泳池。
-1不提供,非负数值表示使用计费(计费单位:
swyyc
室外游泳池。
返回合作网站上该酒店的ID号。
◆酒店类别和子类别划分的规范如下所示,其中黑体字代表父类别,斜体字代表子类别(例如:
“酒店宾馆”、“旅馆客栈”是父类别,“经济型酒店”是酒店宾馆的子类别,“特色客栈”是旅馆客栈的子类别)。
合作网站参考如下内容,根据其实际情形作解析以及与本网站自有的类别设置作对应。
酒店宾馆:
五星级
四星级
三星级
经济型酒店
商务型酒店
会展会务酒店
顶级豪华酒店
主题酒店
度假休闲酒店
精品酒店
宾馆
招待所
旅馆客栈:
青年旅舍
国际青年旅舍
特色客栈
家庭旅馆
农家乐
四合院
短租公寓:
酒店式公寓
家庭式公寓
豪宅
集体宿舍
阁楼
度假村:
度假村
其它:
独栋别墅
林间小屋
城堡
树屋
船舱
房车
冰屋
海边小屋
活动场地
会议室
会所
2.5房源信息
2.5.1房管通推送房源信息
◆店家用户在房管通系统维护其在房管通上的房型信息
◆该业务要求房管通向合作网站推送店家的房型信息
◆合作网站根据其数据需求,解析和保存该用户的房型信息,并返回处理结果
roomclass_list
房型集合。
多条房型数据的集合,针对每一条房型数据,详细的数据规格见下文。
⏹房型的数据规格如下:
roomclass_fgt_id
该房型在房管通系统中的唯一ID标识
roomclass_name
房型名称
roomclass_title
房型标题
roomclass_feature
房间特色
roomclass_introductions
房型简介
roomclass_quantity
房管通第一次推送房源信息时,该数值对应的是该房型店家所拥有的房间数量。
第一次推送之后,房管通获取合作网站上对应于该房型的ID并在房管通中建立房型关联。
房管通后续维护这种关联关系,并在后续的房源信息推送中根据关联对应的关系推送相应房型的留房数量。
roomclass_dailyprice
一日价。
第一次推送时是该房型价格的初始值。
后续推送时根据房管通房型关联推送的价格更新值。
roomclass_weekendprice
周末价。
roomclass_weekprice
一周价。
roomclass_monthlyprice
一月价。
roomclass_deposit
前台押金。
roomclass_lease_type
出租方式。
0整套出租;
1单间(非隔断);
2单间(隔断);
3床铺;
4沙发
roomclass_capacity
可住人数
roomclass_capacity_extend
额外可加人数
roomclass_bedroom_num
卧室数量
roomclass_parlour_num
客厅数量
roomclass_kitchen_num
厨房数量
roomclass_bathroom_num
卫生间数量
roomclass_balcony_num
阳台数量
roomclass_study_num
书房数量
roomclass_bathroom_type
卫生间类型。
0独立卫生间;
1公共卫生间
roomclass_storey_num
所在楼层是第几层
roomclass_storey_total
总共楼层数
roomclass_orientations
房屋朝向,1-8对应东、西、南、北、东南、东北、西南、西北
roomclass_room_area
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 网站 对接 规范
![提示](https://static.bingdoc.com/images/bang_tan.gif)