优优好房(Html)文档

0、优优好房接口:文档说明
1、优优好房获取出售房源列表接口
2、优优好房获取出租房源列表接口
3、优优好房获取公司信息接口
4、优优好房获取用户信息接口
5、优优好房获取分店信息接口 Marlin@2018-07@永州

0、优优好房接口:文档说明

优优好房，为成都`好房通`科技股份有限公司的旗下房产中介系统，此接口文档仅用于旗下合作门店。

服务器通过COMP_NO及SYNC_VERIFYID（请妥善保管）进行身份验证，如需要开通数据同步功能，请联系优优好房客服。

每个接口访问频率不可低于3分钟/次，间隔期间接口将会被锁定，因此请勿使用多线程同步模式，鉴于方便用户的开发和调试方便，可以联系客服开放1周的开发时间，期间服务器不会针对接口执行锁定(锁定时返回值如下：{"DATA":[],"ERRCODE":"1","ERRMSG":"LOCK_TIME:123ms","SERVER_TIME":"2015-07-23 14:44:24.58","TOTAL":"0"})

房源列表每次返回服务器端计算后的一个时间段的数据，因此每次返回的数据量根据时间段内数据量的不同而不同（最多50条，超过部分服务器端自动分页,由于算法自身缺陷可能会出现返回0条的情况，请忽略继续执行），服务器通过时间游标指定同步的时间节点，保障数据的完整性，用户也可指定游标的初始时间节点（服务器端会自动记录时间节点，除非重新初始化，请勿人为指定），如有疑问请联系客服。

示例(请替换参数值)：
{root} = `http://user.haofang.net/hftWebService/web/openApi/data`

获取出售出售房源列表数据
{root}/getSaleList? COMP_NO=***&SYNC_VERIFYID=***

指定重新获取上一次数据（当系统超时，或者解析错误时）
{root}/getSaleList? COMP_NO=***&SYNC_VERIFYID=***&RECENT_FLAG=1

指定初始更新时间节点(初始时间为2015-01-01)
{root}/getSaleList? COMP_NO=***&SYNC_VERIFYID=***&LAST_TIME_SALE=2015-01-01

1、优优好房获取出售房源列表接口

访问地址
{root}/getSaleList
参数 必须 释意
COMP_NO 是 公司编号
SYNC_VERIFYID 是 公司唯一检验码（请谨慎保管）
LAST_TIME_SALE 否 指定更新时间节点
RECENT_FLAG 否 指定是否重新获取  0 否 1 是
返回值
参数 释意
DATA 数据集
ERRCODE 错误编号
ERRMSG 错误信息
LAST_TIME_SALE 本次更新时间节点
NEXT_TIME_SALE 下次更新时间节点
SERVER_TIME 系统时间
TOTAL 总数
数据集
参数 释意
BUILD_CODE 楼盘检索码
BUILD_ID 楼盘ID
BUILD_NAME 楼盘名称
DEPT_ID 门店ID
EXPLRTH_DATETIME 房勘日期
GARAGE_AMOUNT 车位数量
GARDEN_AREA 花园面积
HALL_STRUCTURE 厅结构
IS_SEPERATOR 是否可分割（1：是  0：否）
OFFICE_LEVEL 写字楼级别
PHOTO_ARRAY 房源图片数组
参数 释意
IS_TOP 首图标记
PHOTO_ID 图片ID
PHOTO_SEQ 图片排序字段
PHOTO_ADDR 图片地址
REGION_NAME 行政区名称
RICH_TEXT 富文本
SALE_AREA 建筑面积
SALE_CHARACT 配套及特色
SALE_DIRECT 房源朝向
SALE_DOORS 几户
SALE_EXPLRTH 房勘（1：已勘  0：未勘）
SALE_FITMENT 装修
SALE_FLOOR 所在楼层
SALE_FLOORS 总楼层
SALE_HALL 几厅
SALE_ID 房源ID
SALE_INNERAREA 套内面积
SALE_LADDER 几梯
SALE_LEAVE_TIME 腾房日
SALE_MAP 图片张数
SALE_MEMO 内部备注
SALE_MORTGAGE 现状(按揭)
SALE_NO 房源编码
SALE_PROPERTY 物业费
SALE_PUBLISH 是否发布（1：是  0：否）
SALE_REG 行政区ID
SALE_RIGHT 产权
SALE_ROOM 几房
SALE_ROUND 环域
SALE_STATUS
1 有效 7 注销
2 封盘 101 转售
3 暂缓 102 转租
4 预订 103 转有效
5 内成交 104 转私盘
6 外成交    
SALE_STREET 是否邻街（1：是  0：否）
SALE_STRUCT 房屋结构
SALE_SUBJECT 房源标题
SALE_TOTAL_PRICE 售价
SALE_TYPE 房源类型
SALE_UNIT_PRICE 单价
SALE_USEAGE 房屋用途
SALE_WEI 几卫
SALE_YANG 阳台
SALE_YEAR 房屋年代
SECTION_ID 片区Id
SECTION_NAME 片区名称
SHOP_USAGE 商铺用途
TAG_IDS 房源标签
THUMB_URL 缩略图文件路径
TRADE_ADDR 商铺地址
UG_AREA 地下面积
UG_TYPE 地下类型
USER_ID 经纪人ID
UPDATE_TIME 最后更新时间
VIDEO_NUM 视频数量
VEDIO_INFO
VIDEO_ID 视频ID
VIDEO_ADDR 视频地址
PHOTO_ADDR 图片地址
TORRENT_ADDR Torrent地址

2、优优好房获取出租房源列表接口

访问地址
{root}/getLeaseList
参数 必须 释意
COMP_NO 是 公司编号
SYNC_VERIFYID 是 公司唯一检验码（请谨慎保管）
LAST_TIME_LEASE 否 指定更新时间节点
RECENT_FLAG 否 指定是否重新获取  0 否 1 是
返回值
参数 释意
DATA 数据集
ERRCODE 错误编号
ERRMSG 错误信息
LAST_TIME_LEASE 本次更新时间节点
NEXT_TIME_LEASE 下次更新时间节点
SERVER_TIME 系统时间
TOTAL 总数
数据集
参数 释意
BUILD_CODE 楼盘检索码
BUILD_ID 楼盘ID
BUILD_NAME 楼盘名称
GARAGE_AMOUNT 车位数量
GARDEN_AREA 花园面积
HALL_STRUCTURE 厅结构
IS_SEPERATOR 是否可分割（1：是  0：否）
LEASE_ACCOUNT 结算
LEASE_AREA 建筑面积
LEASE_CHARACT 配套及特色
LEASE_DEPOSIT 租房押金
LEASE_DIRECT 房源朝向
LEASE_DOORS 几户
LEASE_EXPLRTH 房勘（1：已勘  0：未勘）
LEASE_FITMENT 装修
LEASE_FLOOR 所在楼层
LEASE_FLOORS 总楼层
LEASE_HALL 几厅
LEASE_ID 房源ID
LEASE_INNERAREA 套内面积
LEASE_LADDER 几梯
LEASE_LEAVE_TIME 腾房日
LEASE_LIMITE 租房期限
LEASE_MAP 图片张数
LEASE_MEMO 内部备注
LEASE_NO 房源编码
LEASE_PROPERTY 物业费
LEASE_PUBLISH 是否发布（1：是  0：否）
LEASE_REG 行政区ID
LEASE_ROOM 几房
LEASE_ROUND 环域
LEASE_SET 室内配套
LEASE_STATUS
1 有效 7 注销
2 封盘 101 转售
3 暂缓 102 转租
4 预订 103 转有效
5 内成交 104 转私盘
6 外成交    
LEASE_STREET 是否邻街（1：是  0：否）
LEASE_SUBJECT 房源标题
LEASE_TOTAL_PRICE 售价 -(租金???)
LEASE_TYPE 房源类型
LEASE_USEAGE 房屋用途

1 		住宅 5 仓库
2 别墅 6 外成交
3 商铺 7 车库
4 写字楼    
LEASE_WEI 几卫
LEASE_YANG 阳台
LEASE_YEAR 房屋年代
OFFICE_LEVEL 写字楼级别
OWNER_TYPE 权属类型
PHOTO_ARRAY 房源图片数组
参数 释意
IS_TOP 首图标记
PHOTO_ID 图片ID
PHOTO_SEQ 图片排序字段
PHOTO_ADDR 图片地址
PHOTO_TIME 首次上传图片时间
PRICE_UNIT 租金单位
REGION_NAME 行政区名称
RICH_TEXT 富文本
SECTION_ID 片区ID
SECTION_NAME 片区名称
SHOP_USAGE 商铺用途
TAG_IDS 房源标签
THUMB_URL 缩略图文件路径
TRADE_ADDR 商铺地址
UG_AREA 地下面积
UG_TYPE 地下类型
USER_ID 经纪人ID
VIDEO_NUM 视频数量
VEDIO_INFO
VIDEO_ID 视频ID
VIDEO_ADDR 视频地址
PHOTO_ADDR 图片地址
TORRENT_ADDR Torrent地址
UPDATE_TIME 最后更新时间

3、优优好房获取公司信息接口

访问地址
{root}/getCompInfo
参数 必须 释意
COMP_NO 是 公司编号
SYNC_VERIFYID 是 公司唯一检验码（请谨慎保管）
返回值
参数 释意
DATA 数据集
ERRCODE 错误编号
ERRMSG 错误信息
SERVER_TIME 系统时间
TOTAL 总数
数据集
参数 释意
APTITUDE_NO 资质编号
CITY_ID 市(县)
COMMERCIAL_NO 执照编号
COMP_ADDR 公司地址
COMP_CNAME 公司简称
COMP_CONTACT 联系人
COMP_DESC 公司描述
COMP_ID 公司ID
COMP_NAME 公司名称
COMP_NO 公司编号
COMP_TELE 联系电话
CUSTOM_LOG 自定义LOG地址
UPDATE_TIME 最后更新时间
UPDATE_UID 最后更新者
WATERIMG 公司自定义水印图片
WATER_CONFIG 水印配置

4、优优好房获取用户信息接口

访问地址
{root}/getUserList
参数 必须 释意
COMP_NO 是 公司编号
SYNC_VERIFYID 是 公司唯一检验码（请谨慎保管）
返回值
参数 释意
DATA 数据集
ERRCODE 错误编号
ERRMSG 错误信息
SERVER_TIME 系统时间
TOTAL 总数
数据集
参数 释意
ARCHIVE_ID 本人id
AREA_ID 大区
AREA_NAME 大区名称
BBS_PHOTO 论坛图片
CITY_ID 城市
CREATION_TIME 信息创建时间
COMP_ID 公司ID
DEPT_ID 分店ID
DEPT_NAME 分店名称
NICK_NAME 用户昵称
PROFESSION_SUB 执业签名
REG_ID 区域ID
REG_NAME 片区名称
UPDATE_TIME 最后更新时间
UPDATE_UID 最后更新者
SERVICE_ZONE 服务片区
USER_ADDRESS 联系地址
USER_BIRTHDAY 用户出生年月
USER_EMAIL 邮箱
USER_FIXEDPH 住宅电话
USER_ICCODE 身份证
USER_ID 用户ID
USER_JOB_DATE 入职日期
USER_MOBILE 手机号码
USER_NAME 用户姓名
USER_NO 用户编号
USER_PHOTO 个人照片
USER_PHOTO_MIN 个人小头像
USER_POSITION 担任职务
USER_QQ QQ
USER_SEX 性别
USER_WRITEOFF 注销标记（1：已注销  0：未注销）
WRITEOFF_TIME 注销日期

5、优优好房获取分店信息接口

访问地址
{root}/getDeptList
参数 必须 释意
COMP_NO 是 公司编号
SYNC_VERIFYID 是 公司唯一检验码（请谨慎保管）
返回值
参数 释意
DATA 数据集
ERRCODE 错误编号
ERRMSG 错误信息
SERVER_TIME 系统时间
TOTAL 总数
数据集
参数 释意
AREA_ID 公司大区ID
AREA_NAME 大区名称
COMP_ID 公司ID
COMP_NO 公司编号
DEPT_ADDR 分店地址
DEPT_CODE 分店拼音
DEPT_CONTACT 联系人姓名
DEPT_ID 分店ID
DEPT_NAME 分店名称
DEPT_NO 分店编号
DEPT_TELE 联系电话
REGION_ID 行政区域ID
REGION_NAME 行政区域名称
REG_ID 片区ID
REG_NAME 片区名称
SEQ_NO 序号
DEPT_DESC 分店描述
UPDATE_TIME 最后更新时间
UPDATE_UID 最后更新者