# 优优好房(Html)文档

## 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 | 最后更新者