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

alibaba.idle.house.idle.rent.trade.uploadcontract (上传合约基础信息)

上传合同基础信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
contract_top_d_t_o ContractTopDto 必须 合约数据
  • └ contract_id
  • String
  • 必须
  • 334231
  • 合约id
  • └ house_id
  • Number
  • 必须
  • 312323
  • 房源id
  • └ rent_start_time
  • Date
  • 必须
  • 2019-03-11 00:00:00
  • 租约开始时间
  • └ rent_end_time
  • Date
  • 必须
  • 2019-03-11 00:00:00
  • 租约结束时间
  • └ rental
  • Number
  • 必须
  • 200000
  • 租金,单位分
  • └ deposit
  • Number
  • 可选
  • 200000
  • 押金,单位分
  • └ first_pay_fee
  • Number
  • 可选
  • 10000
  • 首月一次性费用,单位分
  • └ fixed_charge
  • Number
  • 可选
  • 20000
  • 固定费用,单位分
  • └ pay_cycle
  • Number
  • 必须
  • 3
  • 付款周期: 每次支付几个月的租金
  • └ house_detail_addr
  • String
  • 必须
  • 杭州市余杭区五常街道文一西路福鼎家园晓风苑15-3-702
  • 房源详细地址
  • └ tenant_name
  • String
  • 必须
  • 张三
  • 租客真实姓名
  • └ tenant_gender
  • String
  • 必须
  • F
  • 租客性别,F表示女性,M表示男性
  • └ tenant_phone_no
  • String
  • 必须
  • 137xxxx0985
  • 租客手机号
  • └ tenant_doc_type
  • Number
  • 必须
  • 0
  • 租客证件类型,目前只支持身份证-0
  • └ tenant_doc_no
  • String
  • 必须
  • 312728xxxxxxxx1223
  • 租客身份证号
  • └ tenant_doc_img_ids
  • String []
  • 可选
  • 1,2,3
  • 租客身份证照片id,需要先通过上传接口上传身份证图片获得id
  • └ media_ids
  • String []
  • 必须
  • 1,2,3
  • 合同图片id列表
  • └ landlord_name
  • String
  • 可选
  • 张三
  • 房东主名称
  • └ plat_name
  • String
  • 必须
  • xxx有限公司
  • 商家名称
  • └ operator_name
  • String
  • 可选
  • 李四
  • 经办人姓名
  • └ pay_date_rule
  • Number
  • 必须
  • 1
  • 交租方式:当前仅支持月计费周期,有三种交租方式: 1表示提前0日,2表示固定每期当月1号,3表示固定每期提前一个月
  • └ discount
  • Number
  • 可选
  • 1000
  • 优惠金额

响应参数

名称 类型 示例值 描述
rent_top_result RentTopResult 结果数据
  • └ data
  • Boolean
  • false
  • 业务数据
  • └ success
  • Boolean
  • false
  • 业务数据是否有效
  • └ code
  • String
  • INVALID_PARAM
  • 错误码
  • └ message
  • String
  • 入参不合法
  • 错误消息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleHouseIdleRentTradeUploadcontractRequest req = new AlibabaIdleHouseIdleRentTradeUploadcontractRequest();
AlibabaIdleHouseIdleRentTradeUploadcontractRequest.ContractTopDto obj1 = new AlibabaIdleHouseIdleRentTradeUploadcontractRequest.ContractTopDto();
obj1.setContractId("334231");
obj1.setHouseId(312323L);
obj1.setRentStartTime(StringUtils.parseDateTime("2019-03-11 00:00:00"));
obj1.setRentEndTime(StringUtils.parseDateTime("2019-03-11 00:00:00"));
obj1.setRental(200000L);
obj1.setDeposit(200000L);
obj1.setFirstPayFee(10000L);
obj1.setFixedCharge(20000L);
obj1.setPayCycle(3L);
obj1.setHouseDetailAddr("杭州市余杭区五常街道文一西路福鼎家园晓风苑15-3-702");
obj1.setTenantName("张三");
obj1.setTenantGender("F");
obj1.setTenantPhoneNo("137xxxx0985");
obj1.setTenantDocType(0L);
obj1.setTenantDocNo("312728xxxxxxxx1223");
obj1.setTenantDocImgIds("1,2,3");
obj1.setMediaIds("1,2,3");
obj1.setLandlordName("张三");
obj1.setPlatName("xxx有限公司");
obj1.setOperatorName("李四");
obj1.setPayDateRule(1L);
obj1.setDiscount(1000L);
req.setContractTopDTO(obj1);
AlibabaIdleHouseIdleRentTradeUploadcontractResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_idle_house_idle_rent_trade_uploadcontract_response>
    <rent_top_result>
        <data>false</data>
        <success>false</success>
        <code>INVALID_PARAM</code>
        <message>入参不合法</message>
    </rent_top_result>
</alibaba_idle_house_idle_rent_trade_uploadcontract_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

返回
顶部