开放接口/发布和更新二手房(增值接口)

最后更新:2019-03-22

URL

/rest/resold/esf

HTTP请求方式

POST

注意事项

此接口为增值接口,请求时需添加headers参数pid,time,sign进行校验

headers参数

参数名 必选 类型及范围 说明
pid int 商家id
time string 请求时间,UNIX时间戳格式
sign string 数字签名,生成方式:md5(pid + auth_key + time),auth_key从小编后台商家详情页获取

请求参数

参数名 必选 类型及范围 说明
id int 房源id,不传值为新发布房源,传值为更新房源
uid int 职员论坛账号id,可通过店铺职员列表接口获取
hid int 楼盘id
title string 房源标题
category int 房源类型,该值为1表示住宅,为2表示商铺,为3表示写字楼,默认为1
tags array 房源标签id数组,可通过二手房内置标签接口获取。可填写住宅的类型;商铺的类型、级别;写字楼的类型、级别
tag_esfspkjyxm array 商铺经营项目标签id数组,可通过二手房内置标签接口获取。当category=2时必填
images array 房源图片数组
fullviewArr array 全景数组,url为全景链接,img为全景封面图,url和img必须都传
size float 面积,单位平方米
bedroom int 室,category=1时必填
livingroom int 厅,category=1时必填
bathroom int 卫,category=1时必填
floor int 第几层,category=1时必填
total_floor int 共几层,category=1时必填
image string 封面图
price float 总价,单位万/套
age int 建造年代
towards int 朝向标签id,可通过二手房内置标签接口获取
decoration int 装修程度标签id,可通过二手房内置标签接口获取
wuye_fee string 物业费,单位:元/平米
content string 房源内容
owner_desc string 业主心态,不超过500字符
facilities string 小区配套,不超过500字符
service_desc string 服务介绍,不超过500字符

请求示例

"id": 46,
"title": "出售典雅花园1室1厅1卫1000平米1000万住宅",
"uid":1386
"hid":71
"category": 1,
"tags": [151,299],
"tag_esfspkjyxm": [160,162],
"images": ['http://www.bd.com/1.jpg','http://www.bd.com/2.jpg'],
"fullviewArr":['url'=>'https://img360.fang.com/index.html','img'=>'http://www.bd.com/3.jpg'],
"size": 100,
"age": 2015,
"floor": "1",
"total_floor": "12",
"bedroom": 3,
"livingroom": 1,
"bathroom": 2,
"image": "http://www.bd.com/1.jpg",
"price": 100,
"towards": 8,
"decoration": 10,
"wuye_fee": 2,
"content": "房源内容",
"owner_desc": "业主心态"
"facilities": "小区配套"
"service_desc": "服务介绍"

返回结果

{
    "code": 200,
    "msg": "发布成功",
    "data": {"id": "602028"}
}

返回字段说明

返回值字段 字段类型 字段说明
code integer 状态码
msg string 提示信息
data{}
id integer 房源id