淘宝开放平台

登录
文档中心 > API类目 > 天猫好房集成API

天猫好房集成API

qimen.tmall.alihouse.existinghome.workorder.list (二手房工单拉取)

二手房工单拉取

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
broker_id Number 必须 000001 外部经纪人ID
type Number 必须 1 状态，1-待接单 2-已接单 3-失效
page Number 必须 1 页码
page_size Number 必须 20 页数

响应参数

名称 类型 示例值 描述
qmCode String 200 返回状态
qmMessage String success 返回信息
data Data [] data对象
  • └ id
  • Number
  • 1
  • 工单ID
  • └ status
  • Number
  • 1
  • 状态，1-待接单 2-已接单（待带看） 3-已失效 4带看完成 5带看取消
  • └ delivery_time
  • String
  • 120099333
  • 工单派发时间
  • house
  • House
  • 来源楼盘
  • └ city_cn
  • String
  • 杭州
  • 城市
  • └ district_cn
  • String
  • 余杭
  • 区域
  • └ community_name
  • String
  • 辛福小区
  • 小区
  • └ building_area
  • String
  • 120
  • building_area
  • └ room
  • String
  • 三室
  • 室
  • └ hall
  • String
  • 一厅
  • 厅
  • └ sale_price
  • String
  • 234
  • 价格
  • └ source
  • Number
  • 1
  • 来源方式
  • └ expire_time
  • String
  • 1234444
  • 工单剩余时长
  • └ cancel_reason
  • String
  • 不想看了
  • 取消原因
  • └ close_time
  • String
  • 2022-07-01 10:00:00
  • 工单过期关闭时间
  • └ extra_info
  • String
  • {}
  • JSON类型的字符串，未适配需求变化，后期新增字段以json字符串传递
  • └ see_time
  • String
  • 随时可看
  • 高的话单的带看时间
status String 1 状态

请求示例

{"broker_id":1,"page":1,"type":1,"page_size":20}

响应示例

{
    "qmCode":"200",
    "qmMessage":"success",
    "data":[
        {
                "id":1,
                "status":1,
                "delivery_time":"120099333",
                "house":{
                    "city_cn":"杭州",
                    "district_cn":"余杭",
                    "community_name":"辛福小区",
                    "building_area":"120",
                    "room":"三室",
                    "hall":"一厅",
                    "sale_price":"234"
                },
                "source":1,
                "expire_time":"1234444",
                "cancel_reason":"不想看了",
                "close_time":"2022-07-01 10:00:00",
                "extra_info":"{}",
                "see_time":"随时可看"
        }
    ],
    "status":"1"
}

验签示例

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

错误码解释

错误码 错误描述 解决方案
isp.http-read-timeout
http-service-unknown-error

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部