网站对接规范.doc

网站对接规范 目录 网站对接规范 1 1. 文档目的 2 2. 对接数据规范 3 2.1 用户注册 3 2.2 用户登录 3 2.3 用户信息 4 2.4 酒店信息 6 2.5 房源信息 11 2.5.1 房管通推送房源信息 11 2.5.2 房管通拉取房源信息 16 2.6 房价设置 16 2.6.1 平日价设置 17 2.6.2 周末价设置 17 2.6.3 特殊时段价设置 18 2.6.4 周价设置 19 2.6.5 月价设置 19 2.7 规则设置 20 2.8 房态设置 21 2.9 订单信息 22 2.9.1 房管通拉取订单 22 2.9.2 合作网站推送订单 23 2.9.3 房管通推送订单 25 3. 技术规范 26 3.1 接口签名验证 26 3.2 技术部分二 26 4. 补充说明 27 文档目的 业务对接涵盖内容如下： 用户注册 用户信息 酒店信息 房间信息 房价设置，包括：平日价设置、周末价设置、特殊时段价设置、周价设置、月价设置 规则设置 房态设置 订单信息 下文根据业务对接内容，具体描述对接数据规格。 用户注册 新酒店商家在房管通可以直接注册合作网站的酒店账号，通过这样的方式也同时增加了合作网站的加盟酒店。 该业务要求房管通向合作网站推送用户注册的信息，合作网站根据房管通提供的用户注册信息返回该新账号在本网站注册的处理结果 数据规范： 房管通推送数据的规格如下： 参数名 参数类型 备注 字符型 用户注册账户名 password 字符型 用户注册账户密码 参数名 参数类型 备注 整型 1：处理成功， msg 字符型 提示信息 data （对象类型） 数据结果（可以为空） 合作网站预先提供关于本网站用户注册的规则信息，例如：用户名长度要求、用户名是否可以包含空格和汉字、最低长度要求等 业务描述： 新店家用户使用合作网站的账号，通过房管通系统提供的登录功能，登录到合作网站上（后续操作，店家用户将通过使用该登录账号，维护其在合作网站上的房态、房价、房源等信息） 该业务要求房管通向合作网站推送用户登录的信息，合作网站根据房管通提供的用户登录信息返回该店家用登录的处理结果 数据规范： 房管通推送数据的规格如下： 参数名 参数类型 备注 字符型 用户账户名 password 字符型 用户账户密码 参数名 参数类型 备注 整型 1：处理成功，0值表示处理不成功 msg 字符型 提示信息 data （对象类型） 数据结果（可以为空） 用户信息 业务描述： 店家用户在房管通维护其用户信息（包括基本信息、详细信息、账户信息等） 该业务要求房管通向合作网站推送店家用户信息（包括新增和更新），房管通向合作网站推送店家用户的资料信息 合作网站根据其数据需求，解析和保存用户信息，并返回处理结果 房管通推送数据的规格如下： 参数名 参数类型 备注 username 字符型 合作网站上的用户登录名 user_nickname 字符型 昵称 user_surname 字符型 姓氏 user_name 字符型 名 user_gender 性别。 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 字符型 user_add_phone2 字符型 user_license 字符型 user_license_picture 字符型 user_idnumber 字符型 user_idcard_picture 字符型 user_selfdescription 字符型 user_fi