功能概述

退租接口

• 退租接口，可以由用户或者业主发起退租

接口访问

接口地址

rental/order/terminate

请求方式 Method

POST

Header - Authorization Type : Bearer Token

属性	类型	长度	必填	默认值	说明	访问版本
token	string	32	true		用户身份标识令牌	-

请求参数

属性	类型	长度	必填	默认值	说明
rentalID	int	64	true	0	订单ID
terminationDate	string	256	true		退租日期（用户不填就默认传接口返回的）
deductionDepositFee	int	64	false	0	扣除押金金额（房东发起时可填）
remark	string	256	false	""	备注
terminateStatus	int	64	true	0	退租状态 1.租客发起退租 2.业主发起退租 3.租客确认，未到退租日 4.业主确认，未到退租日 5.退租办理中 6.退租完成

请求示例

{
    "rentalID": 54,
    "deductionDepositFee":200,
    "terminationDate":"2025-11-21",
    "remark":"我不同意扣这么多",
    "terminateStatus":4
}

返回值

属性	类型	必填	描述
response	object	true	响应内容
response.Code	string	true	响应码（例如："200"）
response.Message	string	true	响应信息（例如："Success"）
requestId	string	true	请求唯一 ID（用于排查问题）

返回示例

{
    "response": {
        "Code": "200",
        "Message": "Success"
    },
    "requestId": "b713ecb5-70d6-4c4a-8018-2a3d75b0a3df"
}

错误码

错误码	说明	解决方案
91021	合同ID不能为空	检查参数是否正确
404	Fail	代码报错