文档中心 > API类目 > 天猫好房交易API

qimen.tmall.alihouse.trade.rent.lease.statusnotice (房租宝同步租约至ETC)

天猫好房,房租宝交易线,同步租约至ETC

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
leaseOrderNo String 必须 1232 业务单号
type Number 必须 1 操作类型 1-签约状态同步 2-租约到期 3-发起解约 4-租约关闭
terminateStartTime Number 可选 1232323 解除租约发起时间,时间戳
terminateEndTime Number 可选 13423432 解除租约完成时间,时间戳
terminateReason String 可选 不合法 解约申请原因
contractStatus String 可选 ALL ALL-全部签约完成 FORMAL-正式合同生成
pdfOssKey String 可选 1232,afe 电子合同地址OssKey,多个以逗号分割
supportLandLordTerminate String 可选 Y 是否支持房东发起解约,Y-是,N-否
terminateRoleType Number 可选 1 解约发起人角色,1-租客,2-房东,5-小二
cancelOrderNo String 可选 2022xxxx 解约单号,唯一确认一条解约单
terminateAuditReason String 可选 同意 解约审核意见

响应参数

名称 类型 示例值 描述
status Number 1 成功标志,1-成功,0-失败
qmCode Number 200 返回码200成功,非200失败
qmMsg String success 返回信息
data Boolean true 是否成功

请求示例

{"terminateRoleType":1,"contractStatus":"ALL","terminateEndTime":13423432,"terminateAuditReason":"同意","terminateStartTime":1232323,"pdfOssKey":"1232,afe","type":1,"supportLandLordTerminate":"Y","terminateReason":"不合法","cancelOrderNo":"2022xxxx","leaseOrderNo":"1232"}

响应示例

{
    "status":1,
    "qmCode":200,
    "qmMsg":"success",
    "data":true
}

验签示例

{"qmCode":"sign-check-failure","qmMsg":"Illegal request","status":"不等于1"}

错误码解释

错误码 错误描述 解决方案
isp.http-read-timeout
isp.http-connection-timeout

API工具

FAQ

返回
顶部