文档中心 > API类目 > 闲鱼租房

alibaba.idle.house.item.add (闲鱼租房分散式房源添加)

基于小区,添加分散式房源,最小单位为一个卧室。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rent_item_param RentItemApiDto 必须 房源入参
  • └ around_config
  • String []
  • 可选
  • 1
  • 周边配套: 1-餐饮方便 2-公交 3-学校 4-公园广场 5-超市 6-健身会馆 7-地铁房 8-菜场 9-医院 10-便利店 11-电梯房 12-可短租
  • └ decorate_level
  • Number
  • 必须
  • 1
  • 装修程度:1-豪华装 2-精装 3-简装 4-毛坯
  • └ room_area
  • Number
  • 必须
  • 20
  • 房屋面积:平方米 【整租:总面积 合租:房间面积】
  • └ face
  • Number
  • 可选
  • 1
  • 房屋朝向:1-朝东 2-朝南 3-朝西 4-朝北 5-西北 6-东北 7-东南 8-西南 9-东西 10-南北
  • └ desc
  • String
  • 必须
  • 房屋房屋描述
  • 房屋描述,纯文本300内
  • └ deposit
  • Number
  • 可选
  • 100
  • 押金,单位:分
  • └ bed_room_cnt
  • Number
  • 必须
  • 1
  • 房屋户型-室
  • └ living_room_cnt
  • Number
  • 必须
  • 1
  • 房屋户型-厅
  • └ rent_type
  • Number
  • 必须
  • 1
  • 出租类型 1-长租,当前仅支持长租房源【废弃】
  • └ title
  • String
  • 必须
  • 房屋标题
  • 房屋标题,纯文本60字内
  • └ total_floor
  • Number
  • 必须
  • 1
  • 总楼层
  • └ settling_time
  • Date
  • 可选
  • 2017-11-12 22:22:20
  • 可入住时间
  • └ video_id
  • String
  • 可选
  • videoid
  • 视频ID,废弃
  • └ user_nick
  • String
  • 可选
  • 管家/经纪人淘宝会员名称
  • 管家/经纪人淘宝会员名称
  • └ rent
  • Number
  • 必须
  • 100
  • 租金,单位:分
  • └ building_addr
  • String
  • 可选
  • 3-1-602
  • 房屋门牌号 【待废弃】
  • └ bath_room_cnt
  • Number
  • 必须
  • 1
  • 房屋户型-卫
  • └ pay_mode_paid
  • Number
  • 必须
  • 3
  • 支付方式-付
  • └ room_config
  • String []
  • 可选
  • 1
  • 房屋配套:1-空调 2-冰箱 3-洗衣机 4-燃气灶 5-热水器 6-WIFI 7-电视机 8-电磁炉 9-暖气 10-独立卫生间(合租参数) 11-大阳台 12-微波炉 13-衣柜
  • └ detail_address
  • String
  • 可选
  • 浙江省杭州市余杭区五常街道翡翠城
  • 小区详细地址:省市区街道小区名称 【如果有小区id,可忽略】
  • └ floor
  • Number
  • 必须
  • 1
  • 房屋所在楼层
  • └ video_cover_id
  • Number
  • 可选
  • 1
  • 视频封面图ID 【待废弃】
  • └ house_type
  • Number
  • 可选
  • 2
  • 房源类型:1-集中式公寓 2-分散式公寓 【废弃】
  • └ pay_mode_pre
  • Number
  • 可选
  • 1
  • 支付方式-押
  • └ rent_mode
  • Number
  • 必须
  • 1
  • 租赁模式:1-整租 2-合租
  • └ community_name
  • String
  • 可选
  • 小区名称
  • 小区名称 【如果有小区id,可以不输入】
  • └ image_ids
  • Number []
  • 必须
  • 1
  • 房屋图片ID
  • └ bath_room_type
  • Number
  • 可选
  • 0
  • 是否独立卫生间 0-否 1-是 [合租/单间参数],【废弃】
  • └ house_status
  • Number
  • 必须
  • 0
  • 房源状态:0-待出租 1-已租
  • extra_info
  • Extrainfo
  • 可选
  • 扩展信息
  • └ rent_act_tag
  • String
  • 可选
  • 闲鱼租房活动标记
  • 1 - 租金抵扣 2 - 信用免押 3- 二者均参与【已废弃】
  • └ extra2
  • String
  • 可选
  • 1
  • 扩展信息
  • └ extra3
  • String
  • 可选
  • 1
  • 扩展信息
  • └ extra4
  • String
  • 可选
  • 1
  • 扩展信息
  • └ extra5
  • String
  • 可选
  • 1
  • 扩展信息
  • └ extra6
  • String
  • 可选
  • 1
  • 扩展信息
  • └ extra7
  • String
  • 可选
  • 1
  • 扩展信息
  • └ extra8
  • String
  • 可选
  • 1
  • 扩展信息
  • └ extra9
  • String
  • 可选
  • 1
  • 扩展信息
  • └ extra10
  • String
  • 可选
  • 1
  • 扩展信息
  • rent_address_d_t_o
  • RentAddressDto
  • 可选
  • 地址信息 【有小区id,可忽略】
  • └ lng
  • String
  • 可选
  • 0
  • 经度
  • └ lat
  • String
  • 可选
  • 0
  • 纬度
  • └ total_areas
  • Number
  • 可选
  • 20
  • [合租参数必须]房屋总面积
  • └ room_class
  • Number
  • 可选
  • 1
  • [合租参数必须]卧室类别 1-隔间 2-次卧 3-主卧
  • └ house_class
  • Number
  • 可选
  • 1
  • [合租参数必须] 房源分类 1-别墅 2-普通住宅【废弃】
  • └ community_id
  • Number
  • 可选
  • 1
  • 小区id[2018/5月后入驻的机构必须输入]
  • └ lender_nick
  • String
  • 可选
  • 房东主淘宝会员名称
  • 房东主淘宝会员名称[saas平台可支持录入]
  • └ flat_building
  • String
  • 可选
  • 13
  • 门牌-楼/栋 长度 1-6 【2018/5月后入驻的机构必须输入】
  • └ flat_unit
  • String
  • 可选
  • 1
  • 门牌-单元 长度 1-6【2018/5月后入驻的机构输入】
  • └ room_num
  • String
  • 可选
  • 602
  • 门牌号 长度 1-6【2018/5月后入驻的机构必须输入】
  • └ room_name
  • String
  • 可选
  • 1号房
  • 房间名称【2018/5月后入驻的机构,合租房源必须输入】
  • └ vr_token
  • String
  • 可选
  • vrToken
  • vrToken
  • └ saas_landlord_house
  • Boolean
  • 可选
  • false
  • 是否是saas二房东房源
  • └ verification_code
  • String
  • 可选
  • 123567
  • 房屋核验码
  • └ no_verification_reason
  • String
  • 可选
  • 不需核验码的理由
  • 不需核验码的理由
  • └ unique_house_id
  • String
  • 可选
  • 8888
  • 服务商的房源id,用于去重
  • house_verify_dto
  • HouseVerifyDto
  • 可选
  • 成都地区的核验信息
  • └ house_owner_card_no
  • String
  • 可选
  • 330876198809081123
  • 房产证所有者身份证号
  • └ house_no
  • String
  • 可选
  • 2016112400F99990
  • 不动产权证号
  • └ house_owner_name
  • String
  • 可选
  • 张三
  • 房产证所有者姓名
  • └ publisher_type
  • String
  • 可选
  • 2
  • 发布主体类型(2-经纪机构,3-租赁住房企业)
  • └ org_name
  • String
  • 可选
  • 杭州海岛房地产经纪有限公司
  • 机构名称
  • └ business_license
  • String
  • 可选
  • 91420100MA4KNCBW2B
  • 机构统一社会信用代码
  • └ id_card
  • String
  • 可选
  • 123456788900
  • 经纪人身份证号/个人身份证号/租赁住房企业人员身份证
  • └ id_name
  • String
  • 可选
  • 李四
  • //纪人名称/个人名称/租赁住房企业人员名称
  • └ district
  • String
  • 可选
  • 天府新区
  • 行政区域
  • wuhan_verify_dto
  • WuhanVerifyDto
  • 可选
  • 武汉地区的核验信息
  • └ corp_name
  • String
  • 可选
  • 杭州海岛房地产经纪有限公司
  • 企业名称
  • └ business_code
  • String
  • 可选
  • 91420100MA4KNCBW2B
  • 企业统一社会信用代码
  • └ corporation
  • String
  • 可选
  • 张三
  • 企业法定代表人
  • └ broker_name
  • String
  • 可选
  • 李四
  • 经纪人姓名
  • └ broker_num
  • String
  • 可选
  • 120922199603130012
  • 经纪人身份证号
  • └ house_code
  • String
  • 可选
  • 20230301ZLXmqQq
  • 房源编码
  • └ org_name
  • String
  • 必须
  • 杭州租房经纪公司
  • 营业执照公司名称
  • └ org_license
  • String
  • 必须
  • 2443284182N121
  • 统一社会信用代码或营业执照号(营业执照公司税号)
  • └ manage_type
  • Number
  • 必须
  • 2
  • 经营范围(2---房地产经纪机构、3---住房租赁机构、4---经纪机构和租赁机构)
  • └ back_images
  • Number []
  • 可选
  • [1231233414,234242342]
  • 备案证明图片
  • └ staff_id
  • String
  • 可选
  • 123456
  • 从业人员卡编号
  • └ staff_name
  • String
  • 可选
  • 张三
  • 从业人员名称
  • └ staff_id_card
  • String
  • 可选
  • 8977312313
  • 从业人员身份证号
  • xuzhou_verify_dto
  • XuzhouVerifyDto
  • 可选
  • 徐州地区核验信息
  • └ house_promotion_code
  • String
  • 可选
  • 03J7AA17
  • 房源推广码
  • └ house_unique_code
  • String
  • 可选
  • 2202342003796860
  • 房源唯一标识

响应参数

名称 类型 示例值 描述
result IdleResultDo result result
  • └ error_code
  • String
  • errorCode
  • errorCode
  • └ data
  • Number
  • 1
  • 商品id
  • └ error_msg
  • String
  • errorMsg
  • errorMsg
  • └ success
  • Boolean
  • true
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleHouseItemAddRequest req = new AlibabaIdleHouseItemAddRequest();
AlibabaIdleHouseItemAddRequest.RentItemApiDto obj1 = new AlibabaIdleHouseItemAddRequest.RentItemApiDto();
obj1.setAroundConfig("1");
obj1.setDecorateLevel(1L);
obj1.setRoomArea(20L);
obj1.setFace(1L);
obj1.setDesc("房屋房屋描述");
obj1.setDeposit(100L);
obj1.setBedRoomCnt(1L);
obj1.setLivingRoomCnt(1L);
obj1.setRentType(1L);
obj1.setTitle("房屋标题");
obj1.setTotalFloor(1L);
obj1.setSettlingTime(StringUtils.parseDateTime("2017-11-12 22:22:20"));
obj1.setVideoId("videoid");
obj1.setUserNick("管家/经纪人淘宝会员名称");
obj1.setRent(100L);
obj1.setBuildingAddr("3-1-602");
obj1.setBathRoomCnt(1L);
obj1.setPayModePaid(3L);
obj1.setRoomConfig("1");
obj1.setDetailAddress("浙江省杭州市余杭区五常街道翡翠城");
obj1.setFloor(1L);
obj1.setVideoCoverId(1L);
obj1.setHouseType(2L);
obj1.setPayModePre(1L);
obj1.setRentMode(1L);
obj1.setCommunityName("小区名称");
obj1.setImageIds(new Long[] { 1 };
);
obj1.setBathRoomType(0L);
obj1.setHouseStatus(0L);
AlibabaIdleHouseItemAddRequest.Extrainfo obj2 = new AlibabaIdleHouseItemAddRequest.Extrainfo();
obj2.setRentActTag("闲鱼租房活动标记");
obj2.setExtra2("1");
obj2.setExtra3("1");
obj2.setExtra4("1");
obj2.setExtra5("1");
obj2.setExtra6("1");
obj2.setExtra7("1");
obj2.setExtra8("1");
obj2.setExtra9("1");
obj2.setExtra10("1");
obj1.setExtraInfo(obj2);
AlibabaIdleHouseItemAddRequest.RentAddressDto obj3 = new AlibabaIdleHouseItemAddRequest.RentAddressDto();
obj3.setLng("0");
obj3.setLat("0");
obj1.setRentAddressDTO(obj3);
obj1.setTotalAreas(20L);
obj1.setRoomClass(1L);
obj1.setHouseClass(1L);
obj1.setCommunityId(1L);
obj1.setLenderNick("房东主淘宝会员名称");
obj1.setFlatBuilding("13");
obj1.setFlatUnit("1");
obj1.setRoomNum("602");
obj1.setRoomName("1号房");
obj1.setVrToken("vrToken");
obj1.setSaasLandlordHouse(false);
obj1.setVerificationCode("123567");
obj1.setNoVerificationReason("不需核验码的理由");
obj1.setUniqueHouseId("8888");
AlibabaIdleHouseItemAddRequest.HouseVerifyDto obj4 = new AlibabaIdleHouseItemAddRequest.HouseVerifyDto();
obj4.setHouseOwnerCardNo("330876198809081123");
obj4.setHouseNo("2016112400F99990");
obj4.setHouseOwnerName("张三");
obj4.setPublisherType("2");
obj4.setOrgName("杭州海岛房地产经纪有限公司");
obj4.setBusinessLicense("91420100MA4KNCBW2B");
obj4.setIdCard("123456788900");
obj4.setIdName("李四");
obj4.setDistrict("天府新区");
obj1.setHouseVerifyDto(obj4);
AlibabaIdleHouseItemAddRequest.WuhanVerifyDto obj5 = new AlibabaIdleHouseItemAddRequest.WuhanVerifyDto();
obj5.setCorpName("杭州海岛房地产经纪有限公司");
obj5.setBusinessCode("91420100MA4KNCBW2B");
obj5.setCorporation("张三");
obj5.setBrokerName("李四");
obj5.setBrokerNum("120922199603130012");
obj5.setHouseCode("20230301ZLXmqQq");
obj1.setWuhanVerifyDto(obj5);
obj1.setOrgName("杭州租房经纪公司");
obj1.setOrgLicense("2443284182N121");
obj1.setManageType(2L);
obj1.setBackImages(new Long[] { 1231233414,234242342 };
);
obj1.setStaffId("123456");
obj1.setStaffName("张三");
obj1.setStaffIdCard("8977312313");
AlibabaIdleHouseItemAddRequest.XuzhouVerifyDto obj6 = new AlibabaIdleHouseItemAddRequest.XuzhouVerifyDto();
obj6.setHousePromotionCode("03J7AA17");
obj6.setHouseUniqueCode("2202342003796860");
obj1.setXuzhouVerifyDto(obj6);
req.setRentItemParam(obj1);
AlibabaIdleHouseItemAddResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_idle_house_item_add_response>
    <result>
        <error_code>errorCode</error_code>
        <data>1</data>
        <error_msg>errorMsg</error_msg>
        <success>true</success>
    </result>
</alibaba_idle_house_item_add_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部