开放接口/发布和更新租房(增值接口)
最后更新:2019-03-25
URL
/rest/resold/zf
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 |
rent_type | 是 | int | 租房方式,1表示整租,2表示合租,3表示不限 |
sp_type | 否 | int | 商铺类别,1表示商铺出租,2表示商铺转让,默认为1 |
transfer_fee | 否 | int | 商铺转让费,单位:万元 |
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": "出租典雅花园3室1厅1卫100平米5000元/月住宅",
"uid":1386
"hid":71
"category": 1,
"rent_type": 1,
"sp_type": 1,
"transfer_fee": 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 |