淘宝开放平台

登录
文档中心 > API类目 > 拍卖API

拍卖API

qimen.taobao.auction.loan.insurance.policy.pre.save (预保保单资料保存)

贷款保险单跳经纪机构进行预保检查前，先保存保单信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bizReqId String 必须 345afd343f 请求随机标识串
bizId String 必须 fd343 拍卖业务编号
policyholder PersonalDO 必须 投保人信息
  • └ name
  • String
  • 必须
  • 张三
  • 姓名
  • └ idCard
  • String
  • 必须
  • 33011020010101111x
  • 身份证号码
  • └ phone
  • String
  • 必须
  • 13333332222
  • 手机号码
insureds PersonalDO [] 必须
  • 最大列表长度：100
    		•  被保人信息
    • └ phone
    • String
    • 必须
    • 13333332222
    • 手机号码
    • └ idCard
    • String
    • 必须
    • 33011020010101111x
    • 身份证号码
    • └ name
    • String
    • 必须
    • 张三
    • 姓名
    auctionUrl String 必须 https://sf-item.taobao.com/sf_item/111.htm 标的链接URL
    houseType String 必须 0010 房屋类型
    houseAddress String 必须 浙江省杭州市西湖区xx路xx小区x-xxx室 房屋地址
    houseLocation String 必须 310013 房屋所在地区编码
    buildingArea String 可选 120 房屋建筑面积(平方米)
    appraisedValue Number 必须 3400000 房屋评估价(单位：分)
    insuranceRate Number 必须 6 全款费率（家财险、履约险总和，万分位）
    policyDate String 必须 2025-04-21 15:22:12 投保日期(yyyy-MM-dd HH:mm:ss)
    policyDeposit Number 必须 345500 保费定金金额（单位：分）
    insuranceCompanies Number [] 必须 1
  • 最大列表长度：100
    		•  可选的承接保司(1-太保)
    callback String 必须 https://ss.taobao.com/callback.do 预保结果回调URL
    houseUse String 可选 住宅 房屋用途

    响应参数

    名称 类型 示例值 描述
    success Boolean true 保存结果，true-成功，false-失败
    bizErrorMsg String 参数错误 错误信息
    bizErrorCode String SYSTEM_ERROR 错误编码
    redirectUrl String https://xxx/xxx 跳转的URL

    请求示例

    1
    {"policyholder":{"phone":"13333332222","idCard":"33011020010101111x","name":"张三"},"appraisedValue":3400000,"insuranceRate":2000,"bizReqId":"345afd343f","insureds":[{"phone":"13333332222","idCard":"33011020010101111x","name":"张三"}],"houseType":"其它","insuranceCompanies":[1],"buildingArea":"120","auctionUrl":"https://sf-item.taobao.com/sf_item/111.htm","policyDate":"2025-04-21 15:22:12","policyDeposit":345500,"bizId":"fd343","callback":"https://ss.taobao.com/callback.do","houseLocation":"330106","houseAddress":"浙江省杭州市西湖区xx路xx小区x-xxx室","houseUse":"住宅"}

    响应示例

    1
    2
    3
    4
    5
    6
    {
        "success":true,
        "bizErrorMsg":"参数错误",
        "bizErrorCode":"SYSTEM_ERROR",
        "redirectUrl":"https:\/\/xxx\/xxx"
    }

    验签示例

    1
    {"bizErrorMsg":"Illegal request","success":"不等于true","bizErrorCode":"sign-check-failure"}

    错误码解释

    错误码 错误描述 解决方案

    API工具

    错误码查询工具 SDK下载

    FAQ

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