[TOC]

三、产权认证API

3.1 待办中心

1. 登录鉴权

  请求地址：/uhome-portal/portal/auth/login.json【重新对接新视窗的登录鉴权接口】
  页面截图：

img_24.png

2.获取认证信息列表

  请求描述：获取产权认证列表
  请求地址：/bms-web/user/manager/ajaxDataTabels?_rand=1584081874501&organId=1549&nickName=&name=&tel="+tel+"&authFlag=10&buildId=&unitId=&houseId="+houseId+"&userType=&sEcho=1&iColumns=10&sColumns=&iDisplayStart=0&iDisplayLength=10&mDataProp_0=relId&mDataProp_1=nickName&mDataProp_2=name&mDataProp_3=tel&mDataProp_4=communityName&mDataProp_5=houseName&mDataProp_6=userType&mDataProp_7=authFlag&mDataProp_8=applyTime&mDataProp_9=relId&sSearch=&bRegex=false&sSearch_0=&bRegex_0=false&bSearchable_0=true&sSearch_1=&bRegex_1=false&bSearchable_1=true&sSearch_2=&bRegex_2=false&bSearchable_2=true&sSearch_3=&bRegex_3=false&bSearchable_3=true&sSearch_4=&bRegex_4=false&bSearchable_4=true&sSearch_5=&bRegex_5=false&bSearchable_5=true&sSearch_6=&bRegex_6=false&bSearchable_6=true&sSearch_7=&bRegex_7=false&bSearchable_7=true&sSearch_8=&bRegex_8=false&bSearchable_8=true&sSearch_9=&bRegex_9=false&bSearchable_9=true&iSortCol_0=0&sSortDir_0=asc&iSortingCols=1&bSortable_0=true&bSortable_1=true&bSortable_2=true&bSortable_3=true&bSortable_4=true&bSortable_5=true&bSortable_6=true&bSortable_7=true&bSortable_8=true&bSortable_9=true&_=1584081874122
  请求方式：GET
  请求参数：tel:申请人手机号；houseId：房间ID
  响应参数：
名称 位置 类型 必填 描述
relId BODY Long 是 房屋客户关联关系ID
userId BODY STRING 是 用户ID
houseId BODY STRING 是 房间ID
status BODY STRING 是 状态
communityId BODY STRING 是 项目ID
communityName BODY Long 是 项目名称
buildId BODY STRING 是 楼栋ID
unitId BODY STRING 是 单元ID

案例

{
    "body":{
        "iTotalRecords":1,
        "data":[
            {
                "relId":14230552,
                "userId":301520183,
                "houseId":35659747,
                "applyTime":1663143062,
                "applyDesc":"",
                "status":0,
                "defaultFlag":0,
                "communityId":21321189,
                "communityName":"贵阳美的国宾府",
                "buildId":50397031,
                "buildName":"",
                "unitId":50397032,
                "userTypeDesc":"资料不全",
                "authFlag":1,
                "authFlagDesc":"已申请(待认证)",
                "roomNo":"0917",
                "houseName":"贵阳美的国宾府公寓C17栋/0917",
                "tel":"13118506440",
                "name":"王英",
                "fullHouseName":"",
                "nickName":"邻居301520183",
                "houseRelation":1,
                "liveFlg":0
            }
        ],
        "iTotalDisplayRecords":1,
        "draw":1,
        "iStart":0,
        "iLength":20
    },
    "statusCode":"OK",
    "statusCodeValue":200
}

3.添加客户信息

  请求描述：添加客户信息
  请求地址：/bms-web/user/manager/addCustomer
  请求方式：POST
  请求参数：
名称 位置 类型 必填 描述
houseId BODY STRING 否 房屋ID
userId BODY Long 是 用户ID
communityId BODY STRING 是 项目ID
custName BODY STRING 否 客户姓名
custTel BODY STRING 否 客户电话
custType BODY STRING 否 客户类型(业主，租户)
custGender BODY Long 是 业主性别
custCard BODY STRING 是 证件号码
adminUser BODY Integer 否 操作人

页面截图 img_23.png

4.更新客户信息

  请求描述：更新客户信息
  请求地址：/bms-web/user/manager/updateCustomer
  请求方式：POST
  请求参数：
名称 位置 类型 必填 描述
custId BODY Long 否 客户ID
houseId BODY STRING 否 房屋ID
userId BODY Long 是 用户ID
communityId BODY STRING 是 项目ID
custName BODY STRING 否 客户姓名
custTel BODY STRING 否 客户电话
custType BODY STRING 否 客户类型(业主，租户)
custGender BODY Long 是 业主性别
custCard BODY STRING 是 证件号码
adminUser BODY Integer 否 操作人 
  页面截图

img_23.png

5.管家审核通过接口

  请求描述：处理审核通过
  请求地址：/bms-web/user/manager/handlerAuditPass
  请求方式：POST
  请求参数：
名称 位置 类型 必填 描述
houseId BODY STRING 否 房屋ID
communityId BODY STRING 是 项目ID
custId BODY Long 否 客户ID
userId BODY Long 是 用户ID
relId BODY Long 是 房客关联关系ID 
  页面截图：

img_22.png

6.管家审核驳回接口

  请求描述：处理审核驳回
  请求地址：/bms-web/user/manager/handlerAuditReject
  请求方式：POST
  请求参数：
名称 位置 类型 必填 描述
communityId BODY STRING 是 项目ID
userId BODY Long 是 用户ID
relId BODY Long 是 房客关联关系ID

页面截图： img_21.png

7.获取审核用户列表

  请求描述：获取审核用户列表
  请求地址：/bms-web/user/manager/userAuditList
  请求方式：GET
  注意：之前四格的接口返回的是html【此接口需要改造】
  请求参数：
名称 位置 类型 必填 描述
communityId BODY Long 是 项目ID
userId BODY Long 是 用户ID
buildId BODY Long 是 楼栋ID
unitId BODY Long 是 单元ID
roomNo BODY STRING 是 房间ID 
  响应参数：
名称 位置 类型 必填 描述
custId BODY Long 是 客户ID
houseInfo BODY STRING 是 房间信息
custName BODY STRING 是 客户名称
custTel BODY STRING 是 客户电话
custType BODY STRING 是 客户类型
custGender BODY STRING 是 客户性别
custCard BODY STRING 是 客户证件号
houseId BODY Long 是 房间ID 
 页面截图：

img_23.png

 案例：

{
    "body":"\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n<table class=\"table table-bordered no-padding\">\r\n    <tr>\r\n        <td rowspan=\"3\" style=\"text-align: center;vertical-align:middle\">\r\n            <span style=\"color:red;font-size: 16px\">*</span>入住信息：\r\n        </td>\r\n        <th style=\"text-align: center;vertical-align: middle;background: #EFEFEF\">\r\n            <span style=\"color:red;font-size: 16px\">*</span>房屋信息\r\n        </th>\r\n        <th style=\"text-align: center;vertical-align: middle;background: #EFEFEF;\">\r\n            <span style=\"color:red;font-size: 16px\">*</span>客户姓名\r\n        </th>\r\n        <th style=\"text-align: center;vertical-align: middle;background: #EFEFEF;\">\r\n            <span style=\"color:red;font-size: 16px\">*</span>客户电话\r\n        </th>\r\n        <th style=\"text-align: center;vertical-align: middle;background: #EFEFEF;\">\r\n            <span style=\"color:red;font-size: 16px\">*</span>客户类型\r\n        </th>\r\n        <th style=\"text-align: center;vertical-align: middle;background: #EFEFEF;\">\r\n            客户性别\r\n        </th>\r\n        <th style=\"text-align: center;vertical-align: middle;background: #EFEFEF;\">\r\n            身份证\r\n        </th>\r\n        <th style=\"text-align: center;vertical-align: middle;background: #EFEFEF;\">\r\n            操作\r\n        </th>\r\n    </tr>\r\n    \r\n    \r\n        \r\n            <tr>\r\n                <td>\r\n                    <input type=\"hidden\" id=\"custId_0\" value=\"17509029\"/>\r\n                    \r\n                        <input type=\"radio\" checked=\"checked\" name=\"houseRadio\" id=\"houseId_0\" status=\"1\" index=\"0\" value=\"36179625\"/> \r\n                    \r\n                        阜阳美的城19栋2单元704房\r\n                </td>\r\n                <td>\r\n                    \r\n                        <label class=\"input\">\r\n                            <input type=\"text\" id=\"custName_0\" value=\"武金强\">\r\n                        </label>\r\n                    \r\n                    \r\n                </td>\r\n                <td>\r\n                    \r\n                        <label class=\"input\">\r\n                            <input type=\"text\" id=\"custTel_0\" value=\"13081999055\" readonly>\r\n                        </label>\r\n                    \r\n                    \r\n                </td>\r\n                <td style=\"width: 150px;\">\r\n                    \r\n                        <label class=\"input input-file\">\r\n                            <select class=\"select2\" id=\"custType_0\">\r\n                                <option value=\"\">请选择客户类型</option>\r\n                                \r\n                                    <option value=\"1000\"\r\n                                            selected=\"selected\">业主</option>\r\n                                \r\n                                    <option value=\"2001\"\r\n                                            >租户成员</option>\r\n                                \r\n                                    <option value=\"2000\"\r\n                                            >租户</option>\r\n                                \r\n                                    <option value=\"1001\"\r\n                                            >业主成员</option>\r\n                                \r\n                            </select>\r\n                        </label>\r\n                    \r\n                    \r\n                </td>\r\n                <td style=\"width: 150px;\">\r\n                    \r\n                        <label class=\"input input-file\">\r\n                            <select class=\"select2\" id=\"custGender_0\">\r\n                                <option value=\"\">请选择客户性别</option>\r\n                                <option value=\"1\" >女\r\n                                </option>\r\n                                <option value=\"2\" selected=\"selected\">男\r\n                                </option>\r\n                            </select>\r\n                        </label>\r\n                    \r\n                    \r\n                </td>\r\n                <td>\r\n                    \r\n                        <label class=\"input\">\r\n                            <input type=\"text\" id=\"custCard_0\" value=\"341203198611064034\">\r\n                        </label>\r\n                    \r\n                    \r\n                </td>\r\n                <td>\r\n                    \r\n                        <button type=\"button\" class=\"btn btn-primary\"\r\n                                onclick=\"javascript:updateCustomer(0);\">\r\n                            修改\r\n                        </button>\r\n                    \r\n                    \r\n                </td>\r\n            </tr>\r\n        \r\n    \r\n    <tr>\r\n        <td colspan=\"7\" style=\"text-align: left;font-size: 16px;color:red\">\r\n            提醒：请检查客户信息是否正确，若信息有误，请联系客户确认后进行修改。如果无客户信息可在此添加客户信息\r\n        </td>\r\n    </tr>\r\n    <tr>\r\n        <td style=\"text-align: center;vertical-align: middle\">描述：</td>\r\n        <td colspan=\"8\">\r\n            <label class=\"textarea\"> <textarea id=\"remark\" rows=\"3\"\r\n                                               name=\"mark\"></textarea></label>\r\n        </td>\r\n    </tr>\r\n</table>\r\n\r\n\r\n<script type=\"text/javascript\">\r\n    pageSetUp();\r\n</script>\r\n",
    "headers":{
        "Content-Type":[
            "text/html;charset=UTF-8"
        ],
        "Set-Cookie":[
            "rememberMe=deleteMe; Path=/bms-web; Max-Age=0; Expires=Tue, 13-Sep-2022 07:31:45 GMT",
            "JSESSIONID=1wug8rdz2igjj1r6c2bu9abdep;Path=/bms-web",
            "rememberMe=deleteMe; Path=/bms-web; Max-Age=0; Expires=Tue, 13-Sep-2022 07:31:45 GMT",
            "_segiupt_ts=SIAMTGT;path=/;domain=mideadc.com;HTTPOnly",
            "_segiupt_as=6d0bf304-85dc-4130-8268-4209700bf757;path=/;domain=mideadc.com;HTTPOnly",
            "aid=2666377;path=/;domain=mideadc.com",
            "_segiupt_ty=SEGI_B_;path=/;domain=mideadc.com;HTTPOnly"
        ],
        "Date":[
            "Wed, 14 Sep 2022 07:31:46 GMT"
        ],
        "Connection":[
            "keep-alive"
        ],
        "Expires":[
            "Thu, 01 Jan 1970 00:00:00 GMT"
        ],
        "Server":[
            "*****"
        ],
        "Transfer-Encoding":[
            "chunked"
        ],
        "Content-Language":[
            "en-US"
        ]
    },
    "statusCode":"OK",
    "statusCodeValue":200
}

8.管家APP员工切换小区

  请求描述：管家APP员工切换小区
  请求地址：/uhomecp-sso/v1/propertyUser/switchCommunity.json
  请求方式：POST
  请求参数：

img_16.png

  页面截图：

img_20.png

3.2 客户认证

1.提交业主认证

  请求描述：提交业主认证
  请求地址：/uhomecp-sso/v1/userHouse/submitUserAtuh
  请求方式：GET
  接口说明：

img_5.png

  页面截图：

img_12.png

2.用户访问授权接口

  请求描述：用户访问授权接口
  请求地址：/uhomecp-sso/v2/userApp/authorize
  请求方式：POST
  接口说明：

img_12.png

  页面截图：

img_13.png

3.申请人工审核

  请求描述：申请人工审核
  请求地址：/uhomecp-sso/v1/userHouse/submitFailUserAtuh
  请求方式：POST
  接口说明：

img_8.png

  页面截图：

img_14.png

4.我的房屋列表

  请求描述：我的房屋列表
  请求地址：/uhomecp-sso/v1/userHouse/myHouseList
  请求方式：GET
  接口说明：

img_6.png img_7.png img_13.png

  页面截图：

img_15.png

3.3 家庭邀请

1.同意家庭邀请添加客户

  请求描述：同意家庭邀请添加客户
  请求地址：/uhomecp-customer/rest-api/v1/customerRestApiController/addCustomerInfo
  请求方式：POST
  接口说明：

img_9.png

  页面截图

img.png

2.添加客户成功后更新用户ID接口

  请求描述：添加客户成功后更新用户ID接口
  请求地址：/uhomecp-customer/rest-api/v1/customerRestApiController/updateUserIdByCustId
  请求方式：POST
  接口说明：

img_10.png

  页面截图

img.png

3.家庭成员退出，用户迁出，删除用户与客户关联关系

  请求描述：家庭成员退出，用户迁出，删除用户与客户关联关系
  请求地址：/uhomecp-customer/rest-api/v1/customerRestApiController/moveOutUser
  请求方式：POST
  接口说明：

img_11.png

  页面截图：

img_1.png

4.获取用户信息

  请求描述：获取用户信息
  请求地址：/uhomecp-sso/v3/userApp/profile
  请求方式：POST
  接口说明：

img_14.png

  页面截图：

img.png

5.获取用户权限范围内所有项目列表

  请求描述：获取用户权限范围内所有项目列表
  请求地址：/order-admin-api/rest-api/v6/organ/community/getCommunitysByUser
  请求方式：POST
  接口说明：

img_14.png

  页面截图：

img.png

results matching ""

    No results matching ""