文档中心 > API类目 > 闲鱼房源-前台

alibaba.idle.new.house.item.add (闲鱼二手房房源添加)

闲鱼二手房房源添加

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
house_publish_api_dto HousePublishApiDTO 必须 房源发布参数
  • └ must_verification_code
  • Boolean
  • 必须
  • true
  • 是否必须有核验码(是/否)
  • └ video_id
  • String
  • 可选
  • 视频id
  • 视频id
  • └ property_class
  • Number
  • 必须
  • 1
  • 产权类型(1-商品房 2-经济适用房 3-回迁房 4-共有产权房 5-其他 6-公房)
  • └ has_owner_entrust
  • Boolean
  • 必须
  • true
  • 是否获得产权人委托(是/否)
  • └ decorate_level
  • Number
  • 必须
  • 1
  • 装修程度(1-豪华装修 2-精装修 3-简装 4-毛坯)
  • └ room_num
  • String
  • 可选
  • 203室
  • 门牌-室
  • └ unique_house_id
  • String
  • 必须
  • 123
  • 房源ID
  • └ image_ids
  • Number []
  • 必须
  • 123
  • 房屋图片ID
  • └ room_type
  • String
  • 可选
  • 独栋
  • 房屋结构 独栋/联排/复式/平层/跃层/错层/loft/其他
  • └ unit_price
  • Price
  • 可选
  • 8000.0
  • 均价(房源均价,单位:元/㎡)
  • address_info
  • HouseAddressInfo
  • 必须
  • 小区信息
  • 小区信息
  • └ lng
  • String
  • 可选
  • 120.023171
  • 高德经度
  • └ city
  • String
  • 可选
  • 杭州
  • 城市
  • └ district
  • String
  • 可选
  • 余杭区
  • 区域
  • └ community_name
  • String
  • 可选
  • 永福小区
  • 小区名称
  • └ community_id
  • Number
  • 必须
  • 123
  • 小区id
  • └ full_addr
  • String
  • 可选
  • 杭州市余杭区永福小区3栋1单元303室
  • 完整地址
  • └ lat
  • String
  • 可选
  • 30.279902
  • 高德纬度
  • └ property_rights
  • String
  • 可选
  • 单独产权
  • 产权所属 共有产权/单独产权
  • └ room_area
  • BigDecimal
  • 必须
  • 80
  • 直接填建筑面积 单位:㎡
  • └ house_class
  • String
  • 可选
  • 高层
  • 建筑类别(房屋所在楼栋建筑类别,其他、低层、多层、小高层、高层、超高层)
  • └ building_addr
  • String
  • 可选
  • 3栋1单元203室
  • 房屋门牌号
  • seller_info
  • HouseSellerInfo
  • 可选
  • 卖家信息
  • 卖家信息
  • └ org_name
  • String
  • 必须
  • xx公司
  • 经纪人所属经纪公司(营业执照公司名)
  • └ back_images
  • Number []
  • 可选
  • 照片id
  • 经纪人备案证明图片
  • └ staff_shop_name
  • String
  • 必须
  • 我爱我家高教路店
  • 所属经纪门店
  • └ org_license
  • String
  • 必须
  • 123
  • 统一社会信用代码或营业执照号(营业执照公司税号)
  • └ staff_full_name
  • String
  • 必须
  • 所属经纪门店+姓名
  • 经纪人昵称
  • └ staff_phone_number
  • String
  • 必须
  • 18888888888
  • 经纪人手机号
  • └ business_license_image_ids
  • Number []
  • 必须
  • 照片id
  • 营业执照照片
  • └ staff_name
  • String
  • 必须
  • 张三
  • 经纪人姓名
  • └ staff_image_id
  • Number
  • 可选
  • 123
  • 经纪人头像
  • └ staff_id_card
  • String
  • 必须
  • 身份证号
  • 经纪人身份证号
  • └ staff_id
  • String
  • 可选
  • 123
  • 从业人员编号
  • └ owner_name
  • String
  • 可选
  • 李四
  • 房产证所有者姓名
  • └ id_code
  • String
  • 可选
  • 123
  • 房产证所有者身份证号
  • └ has_agency_fee
  • Boolean
  • 必须
  • true
  • 有无买家中介费(是/否)
  • └ total_floor
  • Number
  • 必须
  • 20
  • 总楼层数(该房屋所在楼栋建筑物理楼层数,如:20)
  • └ market_time
  • Number
  • 可选
  • 2020
  • 建成年代(0-2004年以前 1-2004年 2-2005年 3-2006年 4-2007年 5- 2008年 6-2009年 7-2010年 8-2011 年 9-2012年 10-2013年 11-2014年 12-2015年 13-2016年 14-2017年 15-2018年 16-2019年 17-2020年 18-2021年 19-2022年 20-2023年 21-2024年)
  • └ desc
  • String
  • 必须
  • 描述信息
  • 房屋描述
  • └ house_use_class
  • String
  • 必须
  • 住宅
  • 物业类型:普通住宅/别墅/商业/公寓/商住两用/工业厂房/平房/四合院/车库/其他
  • └ total_price
  • Price
  • 必须
  • 230.5
  • 总价 (单位:万元/套)
  • └ has_real_estate_certificate
  • Boolean
  • 必须
  • true
  • 是否取得不动产证(是/否)
  • └ house_age
  • String
  • 可选
  • 满二
  • 房屋年限 满五/满二/不满二
  • └ title
  • String
  • 必须
  • 房屋标题
  • 房屋标题
  • └ elevator_room_ratio
  • String
  • 可选
  • 0.88
  • 梯户比例(是指电梯数和每层楼住户的比例,如0.88)
  • └ real_estate_certificate_number
  • String
  • 可选
  • 123
  • 不动产权证号
  • └ floor_class
  • Number
  • 可选
  • 1
  • 所在楼层 1-低楼层 2-中楼层 3-高楼层
  • └ sale_time
  • Date
  • 必须
  • 2024-04-01 00:00:00
  • 挂牌时间(2024/4/1)
  • └ property_rights_period
  • String
  • 必须
  • 70
  • 产权年限 30/40/45/50/60/65/70/永久产权
  • └ floor
  • Number
  • 必须
  • 8
  • 房屋所在楼层:8层
  • └ flat_building
  • String
  • 可选
  • 1栋
  • 房屋楼栋号
  • └ building_class
  • String
  • 可选
  • 塔楼
  • 建筑类型(板楼/塔楼/塔板结合/叠拼/独栋/联排/双拼/平房/其他)
  • └ community_image_ids
  • Number []
  • 可选
  • 图片id
  • 小区图片
  • └ verification_code
  • String
  • 可选
  • 123
  • 核验码
  • └ publish_body_class
  • String
  • 必须
  • 服务商
  • 发布主体类型 服务商/经纪公司/经纪人/其他
  • └ room_rate
  • String
  • 可选
  • 88.88
  • 得房率
  • └ biz_circles
  • String
  • 可选
  • 万达广场
  • 商圈
  • └ face
  • Number
  • 必须
  • 1
  • 朝向(1-东/2-南/3-西/4-北/5-西北/6-东北/7-东南/8-西南/9-东西/10-南北)
  • └ flat_unit
  • String
  • 可选
  • 1单元
  • 房屋单元号
  • └ detail_address
  • String
  • 可选
  • 杭州市余杭区永福小区
  • 小区详细地址
  • └ has_elevator
  • Number
  • 必须
  • 1
  • 是否有电梯(0-无电梯/1-有电梯)
  • └ has_check_certificate
  • Boolean
  • 必须
  • true
  • 是否产证已验(是/否)
  • └ inner_area
  • String
  • 可选
  • 88.88
  • 套内面积(房屋套内实际使用面积,单位:㎡)
  • └ category_id
  • Number
  • 必须
  • 202034901
  • 商品类目ID
  • └ tags
  • String
  • 可选
  • 南北通透
  • 房源标签(满五/满二/不满二/近地铁/随时看房/新上/降价好房/满五唯一/唯一/七日热门/电梯房/明厨明卫/带车位/南北通透/急售)
  • └ has_parking
  • Number
  • 可选
  • 1
  • 是否带车位(0否/1是/2未知)
  • └ look_time
  • String
  • 可选
  • 周末可看
  • 看房时间(随时可看,周末可看等)
  • └ sale_reason
  • String
  • 可选
  • 破产
  • 业主售卖原因(例如:刚改/结婚/学区/出国/破产等)
  • └ situation
  • Number
  • 可选
  • 1
  • 房屋现状(1-空房 2业主 3-租客住 4-其他)
  • └ layout_pictures_ids
  • Number []
  • 可选
  • 123
  • 户型图id
  • └ ownership_address
  • String
  • 可选
  • 房产证显示地址
  • 房产证地址
  • └ is_only_house
  • Boolean
  • 可选
  • true
  • 是否唯一住房
  • └ bed_room_cnt
  • Number
  • 必须
  • 1
  • 房屋户型 - 室(1≤X≤10)
  • └ living_room_cnt
  • Number
  • 必须
  • 0
  • 房屋户型 - 厅(0≤X≤10)
  • └ bath_room_cnt
  • Number
  • 必须
  • 0
  • 房屋户型 - 卫(0≤X≤10)
  • └ user_nick
  • String
  • 可选
  • 张三
  • 闲鱼经纪人会员号

响应参数

名称 类型 示例值 描述
result EasyResultDTO 返回结果
  • └ data
  • Number
  • 123
  • 商品id
  • └ success
  • Boolean
  • true/false
  • 是否成功
  • └ error_code
  • String
  • INPUT_PARAMS_ERROR
  • 错误码
  • └ error_msg
  • String
  • 输入参数错误
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleNewHouseItemAddRequest req = new AlibabaIdleNewHouseItemAddRequest();
AlibabaIdleNewHouseItemAddRequest.HousePublishApiDTO obj1 = new AlibabaIdleNewHouseItemAddRequest.HousePublishApiDTO();
obj1.setMustVerificationCode(true);
obj1.setVideoId("视频id");
obj1.setPropertyClass(1L);
obj1.setHasOwnerEntrust(true);
obj1.setDecorateLevel(1L);
obj1.setRoomNum("203室");
obj1.setUniqueHouseId("123");
obj1.setImageIds(new Long[] { 123 };
);
obj1.setRoomType("独栋");
obj1.setUnitPrice("8000.0");
AlibabaIdleNewHouseItemAddRequest.HouseAddressInfo obj2 = new AlibabaIdleNewHouseItemAddRequest.HouseAddressInfo();
obj2.setLng("120.023171");
obj2.setCity("杭州");
obj2.setDistrict("余杭区");
obj2.setCommunityName("永福小区");
obj2.setCommunityId(123L);
obj2.setFullAddr("杭州市余杭区永福小区3栋1单元303室");
obj2.setLat("30.279902");
obj1.setAddressInfo(obj2);
obj1.setPropertyRights("单独产权");
obj1.setRoomArea("80");
obj1.setHouseClass("高层");
obj1.setBuildingAddr("3栋1单元203室");
AlibabaIdleNewHouseItemAddRequest.HouseSellerInfo obj3 = new AlibabaIdleNewHouseItemAddRequest.HouseSellerInfo();
obj3.setOrgName("xx公司");
obj3.setBackImages(new Long[] { 照片id };
);
obj3.setStaffShopName("我爱我家高教路店");
obj3.setOrgLicense("123");
obj3.setStaffFullName("所属经纪门店+姓名");
obj3.setStaffPhoneNumber("18888888888");
obj3.setBusinessLicenseImageIds(new Long[] { 照片id };
);
obj3.setStaffName("张三");
obj3.setStaffImageId(123L);
obj3.setStaffIdCard("身份证号");
obj3.setStaffId("123");
obj3.setOwnerName("李四");
obj3.setIdCode("123");
obj1.setSellerInfo(obj3);
obj1.setHasAgencyFee(true);
obj1.setTotalFloor(20L);
obj1.setMarketTime(2020L);
obj1.setDesc("描述信息");
obj1.setHouseUseClass("住宅");
obj1.setTotalPrice("230.5");
obj1.setHasRealEstateCertificate(true);
obj1.setHouseAge("满二");
obj1.setTitle("房屋标题");
obj1.setElevatorRoomRatio("0.88");
obj1.setRealEstateCertificateNumber("123");
obj1.setFloorClass(1L);
obj1.setSaleTime(StringUtils.parseDateTime("2024-04-01 00:00:00"));
obj1.setPropertyRightsPeriod("70");
obj1.setFloor(8L);
obj1.setFlatBuilding("1栋");
obj1.setBuildingClass("塔楼");
obj1.setCommunityImageIds(new Long[] { 图片id };
);
obj1.setVerificationCode("123");
obj1.setPublishBodyClass("服务商");
obj1.setRoomRate("88.88");
obj1.setBizCircles("万达广场");
obj1.setFace(1L);
obj1.setFlatUnit("1单元");
obj1.setDetailAddress("杭州市余杭区永福小区");
obj1.setHasElevator(1L);
obj1.setHasCheckCertificate(true);
obj1.setInnerArea("88.88");
obj1.setCategoryId(202034901L);
obj1.setTags("南北通透");
obj1.setHasParking(1L);
obj1.setLookTime("周末可看");
obj1.setSaleReason("破产");
obj1.setSituation(1L);
obj1.setLayoutPicturesIds(new Long[] { 123 };
);
obj1.setOwnershipAddress("房产证显示地址");
obj1.setIsOnlyHouse(true);
obj1.setBedRoomCnt(1L);
obj1.setLivingRoomCnt(0L);
obj1.setBathRoomCnt(0L);
obj1.setUserNick("张三");
req.setHousePublishApiDto(obj1);
AlibabaIdleNewHouseItemAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_idle_new_house_item_add_response>
    <result>
        <data>123</data>
        <success>true/false</success>
        <error_code>INPUT_PARAMS_ERROR</error_code>
        <error_msg>输入参数错误</error_msg>
    </result>
</alibaba_idle_new_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

返回
顶部