开发指南

开发前必读

1. 请求协议：生产环境的接口需使用HTTPS协议。
   
2. 请求格式：JSON数据格式,UTF8编码。
   
3. 返回结果/参数说明：开发者需根据code是否为0判断是否调用成功（code意义请见Api规约）。而msg仅作参考，后续可能会有变动，因此不可作为是否调用成功的判据。
   

基本概念介绍

企业用户码：corpId：每个企业都拥有唯一的corpId，获取此信息可在管理后台“企业信息”下查看“企业ID”(需要有管理员权限)。
企业密钥：corpSecret：是企业应用里面用于保障数据安全的“钥匙”，每一个企业都有一个独立的访问密钥，为了保证数据的安全，corpSecret 务必不能泄漏。
应用用户码：agentId：每个应用都有唯一的标签id。
应用密钥：agentSecret：每个应用都有唯一的agentSecret密钥。

授权指南

获取企业凭证

获取企业token是调用API接口的第一步，相当于创建了一个登录凭证，其它的业务API接口，都需要依赖于token来鉴权调用者身份。 因此开发者，在使用业务接口前，要明确token的颁发来源，使用正确的token。
请求方式：POST
开发环境：http://192.168.0.220:5001/api/sys-api/getToken
测试环境：http://zt.3hmis.com:30010/api/sys-api/getToken
生产环境：https://m.jianxiecloud.com/api/sys-api/getToken

入参说明：

请求参数	参数名	参数类型	说明
corpId	用户码	String	管理后台新增生成
timestamp	时间戳	Long	系统实时生成的时间戳。时间戳有效期20秒，不能重复使用
randomCode	随机码	String	8位字母数字组合随机数
signature	密文签名	String	通过corpSecret,timestamp,randomCode三个字段拼接字符串,然后将该字符串通过sha1 Hash算法进行加密获取。 示例：corpsecret=123, timestamp=456, randomCode=ABC,则拼接后得到字符串123456ABC，将该字符串进行sha1加密即可得到凭证

出参说明：

返回参数	参数名	参数类型	说明
code	状态码	int
data	业务数据	Object	token和token有效期（秒）
msg	返回说明	String

请求参数用例：

{
    "corpId":"c077b37bd92e95f9",
    "randomCode":"12345678",
    "timestamp":"1604991971832",
    "signature":"0780c2a5237c0cdb830303326fb6c33c8297b876"
}

返回参数用例：

{
    "code": 0,
    "msg": "ok！"
    "data": {
      "expires_in": 7200,
      "token":"d81fac5268f0e6c2981dff61f9a2fc970hdsxr8uH6lLAHmUyFSf8fLvm4DyKaVj",
    }
}

校验企业凭证

请求方式：POST
开发环境：http://192.168.0.220:5001/api/sys-api/checkToken?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/sys-api/checkToken?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/sys-api/checkToken?token=（正式环境，token为企业凭证）

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Map	unitId
msg	返回说明	String

请求参数用例：

{
}

返回参数用例：

{
  "code": 0,
  "data": {
​    "unitId": "44a0800075"
  },
  "msg": "check success"
}

获取应用凭证

获取应用token是使用应用的第一步，相当于创建了一个应用的使用凭证，若要使用该应用，都需要依赖于应用token来鉴权调用者身份。 因此开发者，在使用应用前，要明确token的颁发来源，使用正确的token。
请求方式：POST
开发环境：http://192.168.0.220:5001/api/sys-api/getAgentToken
测试环境：http://zt.3hmis.com:30010/api/sys-api/getAgentToken
生产环境：https://m.jianxiecloud.com/api/sys-api/getAgentToken

入参说明：

请求参数	参数名	参数类型	说明
agentId	用户码	String	管理后台新增生成
timestamp	时间戳	Long	系统实时生成的时间戳。时间戳有效期20秒，不能重复使用
randomCode	随机码	String	8位字母数字组合随机数
signature	密文签名	String	通过agentSecret,timestamp,randomCode三个字段拼接字符串,然后将该字符串通过sha1 Hash算法进行加密获取。 示例：corpsecret=123, timestamp=456, randomCode=ABC,则拼接后得到字符串123456ABC，将该字符串进行sha1加密即可得到凭证

出参说明：

返回参数	参数名	参数类型	说明
code	状态码	int
data	业务数据	Object	token和token有效期（秒）
msg	返回说明	String

请求参数用例：

{
    "agentId":"c077b37bd92e95f9",
    "randomCode":"12345678",
    "timestamp":"1604991971832",
    "signature":"0780c2a5237c0cdb830303326fb6c33c8297b876"
}

返回参数用例：

{
    "code": 0,
    "msg": "ok！"
    "data": {
      "expires_in": 7200,
      "token":"d81fac5268f0e6c2981dff61f9a2fc970hdsxr8uH6lLAHmUyFSf8fLvm4DyKaVj",
    }
}

校验应用凭证

请求方式：GET
开发环境：http://192.168.0.220:5001/api/sys-api/checkAgentToken?token=（220，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/sys-api/checkAgentToken?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/sys-api/checkAgentToken?token=（正式环境，token为应用凭证）

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Map	企业id：unitId，应用id：agentId
msg	返回说明	String

请求参数用例：

{ }

返回参数用例：

{ "code": 0, "data": { ​ "agentId": "a13be31dbe1ddad66b0534e9c5783bacbe1c776a", "unitId": "44a0800075" }, "msg": "check success" }

企业级接口

新增企业

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/company
测试环境：http://zt.3hmis.com:30010/api/access/company
生产环境：https://m.jianxiecloud.com/api/access/company

调用结果说明：

1、调用成功后会注册企业基本信息、企业账号、企业管理员账号；

2、企业会自动生成建协云管理员角色，企业管理员会绑定建协云管理员角色；

3、如有设置企业类型编号，企业会绑定该企业类型，并为企业在该企业类型下的应用创建一个管理员角色，该管理员角色将拥有该企业类型的权限，企业管理员绑定该管理员角色，并获取到该企业类型下的权限。

4、如果企业已存在，不会再注册企业，会返回企业基本信息、企业账号。

入参说明：

请求参数	参数名	参数类型	说明
unifiedcode	统一信用代码	String	必填。18位字母与数字组合，唯一
unitName	企业名称	String	必填。长度为1~200个utf8字符
loginName	企业账号	String	必填。规则：由应用编码（systemCode)+统一信用代码组成
password	企业密码	String	必填。规则：由应用编码（systemCode）+统一信用代码后6位+“_”组成,若密码为密文且加盐，则需要传入’salt’,’encryType’字段
adminLoginName	管理员账号	String	必填
adminPassword	管理员密码	String	必填
contacts	管理员/联系人姓名	String	必填。长度为1~50个utf8字符
contactsPhone	管理员/联系人手机号	String	必填。由纯数字组成
contactsTel	管理员/联系人办公电话	String	选填。由纯数字或“-”号组成
salt	加密盐	String	选填。企业账号密码加密盐，如果encryType选择1或2时必填
encryType	加密类型	int	选填。0：明文 1：MD5+盐加密（适用施工资料、检测ERP）2：MD5加密大写
systemCode	系统编码	String	选填。例ZHGD
typeCodes	企业类型	List<String>	选填。企业管理员可以在组织中心--企业类型菜单查看企业类型编号，一个企业对多个应用，一个企业在同一个应用只能拥有一种企业类型。必须与systemCodes一一对应
systemCodes	系统编码	List<String>	选填。必须与typeCodes一一对应
isHome	1是0否	int	typeCode对应的应用是否设置为主页
provinceCode	省code	String	选填。由十二位纯数字组成
cityCode	市code	String	选填。由十二位纯数字组成
areaCode	区code	String	选填。由十二位纯数字组成
address	详细地址	String	选填。长度为1~200个utf8字符
artificial	法人代表	String	选填。长度为1~50个utf8字符
artificialPhone	法人代表手机	String	选填。由纯数字或’-‘号组成
artificialType	法人证件类型	String	选填。长度为1~50个utf8字符
artificialId	法人证件号码	String	选填
email	邮箱	String	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String	返回已注册服务器的信息
msg	返回说明	String

data中的字段（成功）：

返回参数	参数名	参数类型	说明
companyCode	企业code	String
entId	企业id	String
unitName	企业名称	String
accountCode	账号code	String
corpId	用户码	String
clientIp	Ip	String
corpSecret	秘钥	String
ucAccountId	用户中心id	String
adminAccountId	管理员账号ID	String	adminLoginName有值时，才会返回
adminUcCode	管理员账号code	String	adminLoginName有值时，才会返回
loginName	企业账号	String
unifiedcode	统一信用代码	String

data中的字段（企业已存在）：

返回参数	参数名	参数类型	说明
companyCode	企业code	String
entId	企业id	String
unitName	企业名称	String
accountCode	账号code	String
corpId	用户码	String
clientIp	Ip	String
corpSecret	秘钥	String
ucAccountId	用户中心id	String
loginName	企业账号	String
unifiedcode	统一信用代码	String

请求参数用例：

{
	"unifiedcode": "913201143393119599Q",
	"unitName": "测试有限公司111123",
	"loginName": "ceshiyouxiangongsi2223",
	"password": "3hmis.123",
	"adminLoginName": "ceshiyouxianadmin2223",
	"adminPassword": "3hmis.123",
	"contacts": "管理员",
    "typeCodes": ["TYPE00043", "TYPE00151"],
    "systemCodes": ["BX","JIAO"],
	"contactsPhone": "15575528559"
}

返回参数用例（成功）：

{
    "code": 0,
    "status": 0,
    "data": {
        "companyCode": "9B448091",
        "ucAccountId": "dbb464f4c199431fabb2ef3d4f55bf91",
        "accountCode": "07E6G7",
        "unitName": "测试有限公司111123",
        "corpId": "ce156cd16f534aac94efcb4e17803140",
        "entId": "d712dfe535a54e0eb40e1908097e2a5d",
        "clientIp": "192.168.0.172",
        "loginName": "ceshiyouxiangongsi2223",
        "adminUcCode": "V1Q85I",
        "corpSecret": "bcad0b5fd8414a42a9194cae4272c054",
        "adminAccountId": "77fc8bf5ece4453499a8f400d6165aa6",
        "unifiedcode": "913201143393119599Q"
    },
    "msg": "操作成功"
}

返回参数用例（已存在）：

{
    "code": 11,
    "status": 11,
    "data": {
        "unitName": "我是一家有格调的有限公司",
        "unifiedcode": "913201143393119599",
        "companyCode": "CS2E67U6",
        "entId": "fa8d77cce58f42d5af29b00f2d4b21fc",
        "accountCode": "26BGE0",
        "corpId": "49deb5c741494d1f92732e81e63010f5",
        "clientIp": "192.168.0.49",
        "corpSecret": "44a7e1d8602e4f6f83b2c9c6aeae220a",
        "ucAccountId": "9943469ce4df4da9b4db89f06056f355",
        "loginName": "PEARL913201143393119599"
    },
    "msg": "企业账号已被占用"
}

新增企业2 - 支持绑定企业注册类型

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/companyTow
测试环境：http://zt.3hmis.com:30010/api/access/companyTow
生产环境：https://m.jianxiecloud.com/api/access/companyTow

调用结果说明：

1、调用成功后会注册企业基本信息、企业账号、企业管理员账号；

2、企业会自动生成建协云管理员角色，企业管理员会绑定建协云管理员角色；

3、设置企业注册类型编码，企业会绑定该注册类型，并为该企业管理员绑定该注册类型的管理员角色组。企业管理员在注册类型绑定的企业类型（应用）中有所有的权限

4、如果企业已存在，不会再注册企业，会返回企业基本信息、企业账号。

5、如果手机号存在，则把该手机号用户绑定成该企业的企业管理员

入参说明：

请求参数	参数名	参数类型	说明
unifiedcode	统一信用代码	String	必填。18位字母与数字组合，唯一
unitName	企业名称	String	必填。长度为1~200个utf8字符
loginName	企业账号	String	必填。规则：由应用编码（systemCode)+统一信用代码组成
password	企业密码	String	必填。规则：由应用编码（systemCode）+统一信用代码后6位+“_”组成,若密码为密文且加盐，则需要传入’salt’,’encryType’字段
adminLoginName	管理员账号	String	必填
adminPassword	管理员密码	String	必填
contacts	管理员/联系人姓名	String	必填。长度为1~50个utf8字符
contactsPhone	管理员/联系人手机号	String	必填。由纯数字组成
categoryCode	企业权限组编号	String	必填。
companyCode	企业编号	String	必填。创建该企业权限组的企业编号
contactsTel	管理员/联系人办公电话	String	选填。由纯数字或“-”号组成
salt	加密盐	String	选填。企业账号密码加密盐，如果encryType选择1或2时必填
encryType	加密类型	int	选填。0：明文 1：MD5+盐加密（适用施工资料、检测ERP）2：MD5加密大写
systemCode	系统编码	String	选填。例ZHGD
isHome	1是0否	int	注册类型中绑定的第一个app应用是否设置为主页
provinceCode	省code	String	选填。由十二位纯数字组成
cityCode	市code	String	选填。由十二位纯数字组成
areaCode	区code	String	选填。由十二位纯数字组成
address	详细地址	String	选填。长度为1~200个utf8字符
artificial	法人代表	String	选填。长度为1~50个utf8字符
artificialPhone	法人代表手机	String	选填。由纯数字或’-‘号组成
artificialType	法人证件类型	String	选填。长度为1~50个utf8字符
artificialId	法人证件号码	String	选填
email	邮箱	String	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String	返回已注册服务器的信息
msg	返回说明	String

data中的字段（成功）：

返回参数	参数名	参数类型	说明
companyCode	企业code	String
entId	企业id	String
unitName	企业名称	String
accountCode	账号code	String
corpId	用户码	String
clientIp	Ip	String
corpSecret	秘钥	String
ucAccountId	用户中心id	String
adminAccountId	管理员账号ID	String	adminLoginName有值时，才会返回
adminUcCode	管理员账号code	String	adminLoginName有值时，才会返回
loginName	企业账号	String
unifiedcode	统一信用代码	String

data中的字段（企业已存在）：

返回参数	参数名	参数类型	说明
companyCode	企业code	String
entId	企业id	String
unitName	企业名称	String
accountCode	账号code	String
corpId	用户码	String
clientIp	Ip	String
corpSecret	秘钥	String
ucAccountId	用户中心id	String
loginName	企业账号	String
unifiedcode	统一信用代码	String

请求参数用例：

{
	"unifiedcode": "913201143393119599Q",
	"unitName": "测试有限公司111123",
	"loginName": "ceshiyouxiangongsi2223",
	"password": "3hmis.123",
	"adminLoginName": "ceshiyouxianadmin2223",
	"adminPassword": "3hmis.123",
	"contacts": "管理员",
	"contactsPhone": "15575528559",
	"categoryId": 2
}

返回参数用例（成功）：

{
    "code": 0,
    "status": 0,
    "data": {
        "companyCode": "9B448091",
        "ucAccountId": "dbb464f4c199431fabb2ef3d4f55bf91",
        "accountCode": "07E6G7",
        "unitName": "测试有限公司111123",
        "corpId": "ce156cd16f534aac94efcb4e17803140",
        "entId": "d712dfe535a54e0eb40e1908097e2a5d",
        "clientIp": "192.168.0.172",
        "loginName": "ceshiyouxiangongsi2223",
        "adminUcCode": "V1Q85I",
        "corpSecret": "bcad0b5fd8414a42a9194cae4272c054",
        "adminAccountId": "77fc8bf5ece4453499a8f400d6165aa6",
        "unifiedcode": "913201143393119599Q"
    },
    "msg": "操作成功"
}

返回参数用例（已存在）：

{
    "code": 11,
    "status": 11,
    "data": {
        "unitName": "我是一家有格调的有限公司",
        "unifiedcode": "913201143393119599",
        "companyCode": "CS2E67U6",
        "entId": "fa8d77cce58f42d5af29b00f2d4b21fc",
        "accountCode": "26BGE0",
        "corpId": "49deb5c741494d1f92732e81e63010f5",
        "clientIp": "192.168.0.49",
        "corpSecret": "44a7e1d8602e4f6f83b2c9c6aeae220a",
        "ucAccountId": "9943469ce4df4da9b4db89f06056f355",
        "loginName": "PEARL913201143393119599"
    },
    "msg": "企业账号已被占用"
}

绑定企业权限组

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/bindUnitCategory?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/bindUnitCategory?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/bindUnitCategory?token=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
unifiedCode	被绑定企业的统一信用编码	String	必填。18位字母与数字组合，唯一
categoryCode	权限组编码	String	必填。
isHome	是否设置模式二	int	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	boolean	true：成功
msg	返回说明	String

请求参数用例：

{
    "unifiedCode": "12370126F49060986B",
    "categoryCode": "jg_1",
    "isHome": 1
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": true,
    "msg": "操作成功"
}

企业校验

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/checkCompany?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/checkCompany?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/checkCompany?token=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
unifiedcode	统一信用代码	String	必填。18位字母与数字组合，唯一

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int	0：不存在；1：已存在
data	返回数据	String	返回已注册企业基本信息、企业账号
msg	返回说明	String

data中的字段（已存在）：

返回参数	参数名	参数类型	说明
companyCode	企业code	String
entId	企业id	String
unitName	企业名称	String
accountCode	账号code	String
corpId	用户码	String
clientIp	Ip	String
corpsecret	秘钥	String
ucAccountId	用户中心id	String
loginName	企业账号	String
unifiedcode	统一信用代码	String

请求参数用例：

{
​	"unifiedcode":"91451200675005125N"
}

返回参数用例：

{
    "code": 1,
    "status": 1,
    "data": {
        "unitName": "我是一家有格调的有限公司",
        "unifiedcode": "913201143393119599",
        "companyCode": "CS2E67U6",
        "entId": "fa8d77cce58f42d5af29b00f2d4b21fc",
        "accountCode": "26BGE0",
        "corpId": "49deb5c741494d1f92732e81e63010f5",
        "clientIp": "192.168.0.49",
        "corpsecret": "44a7e1d8602e4f6f83b2c9c6aeae220a",
        "ucAccountId": "9943469ce4df4da9b4db89f06056f355",
        "loginName": "PEARL913201143393119599"
    },
    "msg": "企业已存在"
}

企业列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/pageCompany?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/pageCompany?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/pageCompany?token=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
unitName	企业名称	String	选填。模糊查询
page	页码	int	选填。默认1
limit	行数	int	选填。默认500

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String	企业信息列表
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
companyCode	企业code	String
entId	企业id	String
unitName	企业名称	String
accountCode	账号code	String
corpId	用户码	String
clientIp	Ip	String
corpsecret	秘钥	String
ucAccountId	用户中心id	String
loginName	企业账号	String
unifiedcode	统一信用代码	String

请求参数用例：

{
    "unitName": "家有格调的有",
    "page": 1,
    "limit": 10
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": [
        {
            "unitName": "我是一家有格调的有限公司",
            "unifiedcode": "913201143393119599",
            "companyCode": "CS2E67U6",
            "entId": "fa8d77cce58f42d5af29b00f2d4b21fc",
            "accountCode": "26BGE0",
            "corpId": "49deb5c741494d1f92732e81e63010f5",
            "clientIp": "192.168.0.49",
            "corpsecret": "44a7e1d8602e4f6f83b2c9c6aeae220a",
            "ucAccountId": "9943469ce4df4da9b4db89f06056f355",
            "loginName": "PEARL913201143393119599"
        }
    ],
    "msg": "操作成功",
    "count": 1
}

查询集团组织关系

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/listCompany?token= & agentToken=（220，token为企业凭证,agentToken为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/access/listCompany?token=&agentToken=（测试环境,token为企业凭证,agentToken为应用凭证）
生产环境：https://m.jianxiecloud.com/api/access/listCompany?token= & agentToken=（正式环境，token为企业凭证,agentToken为应用凭证）

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String	集团组织关系
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
companyCode	企业code	String
entId	企业id	String
unitName	企业名称	String
accountCode	账号code	String
corpId	用户码	String
clientIp	Ip	String
corpsecret	秘钥	String
ucAccountId	用户中心id	String
loginName	企业账号	String
unifiedcode	统一信用代码	String
child	子对象	List<CompanyResultModel>

CompanyResultModel字段为data里面字段，如下

companyCode	企业code	String
entId	企业id	String
unitName	企业名称	String
accountCode	账号code	String
corpId	用户码	String
clientIp	Ip	String
corpsecret	秘钥	String
ucAccountId	用户中心id	String
loginName	企业账号	String
unifiedcode	统一信用代码	String
child	子对象	List<CompanyResultModel>

请求参数用例：

无

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": {
        "unitName": "广州粤建三和软件股份有限公司",
        "unifiedcode": "91440106716305360L",
        "companyCode": "HD860029",
        "entId": "44a0800075",
        "accountCode": "3K17O6",
        "corpId": "577eca3d821e1287",
        "clientIp": "10.42.0.214",
        "corpsecret": "5f53bc6ea70f749249106639a0431d9b",
        "ucAccountId": "e7b4ff344e824c059d90fea5a6d5930e",
        "loginName": "3hadmin",
        "child": [
            {
                "unitName": "广州一洲信息技术有限公司",
                "unifiedcode": "914401157519770905",
                "companyCode": "058842XI",
                "entId": "7f1128a7f632405ebf2331d5eb47a1c4",
                "accountCode": "9WDZKU",
                "corpId": "2a5988f931896621",
                "clientIp": "192.168.0.220",
                "corpsecret": "4a0ad3345bb9a28f72b1bf50b48103eb",
                "ucAccountId": "5e399f95a5e3419faab260a3b10e1ce2",
                "loginName": "3hyzadmin",
                "child": []
            }
        ]
    },
    "msg": "操作成功"
}

修改企业

请求方式：POST/JSON 开发环境：http://192.168.0.220:5001/api/access/updateCompany?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/updateCompany?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/updateCompany?token=（正式环境，token为企业凭证）

调用成功结果说明：

1、当前只修改企业名称。

2、企业名称修改后，企业账号名称也一起修改。

入参说明：

请求参数	参数名	参数类型	说明
unifiedcode	统一信用代码	String	必填。统一信用代码要与企业凭证所属企业的统一信用代码一致
unitName	企业名称	String	必填
contacts	联系人	String	选填
contactsPhone	联系人手机号	String	选填
unitMail	企业邮箱	String	选填
provinceCode	省code	String	选填。由十二位纯数字组成
cityCode	市code	String	选填。由十二位纯数字组成
areaCode	区code	String	选填。由十二位纯数字组成

请求参数用例：

{
    "unifiedcode": "91430000MA4PKPHTXG",
    "unitName":"湖南建工控股集团有限公司1",
    "contacts": "",
    "contactsPhone": "",
    "unitMail": "11@1.com",
    "provinceCode": "430000000000",
    "cityCode": "430100000000",
    "areaCode": "430103000000"
}

返回参数：

字段	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": "",
    "msg": "修改成功"
}

新增部门

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/dept?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/dept?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/dept?token=（正式环境，token为企业凭证）

调用成果结果说明：

1、部门是建协云下的行政组织类型，不会加入企业自定义的组织类型。

2、部门会新增到企业凭证所属的企业下。

入参说明：

请求参数	参数名	参数类型	说明
deptId	组织管理id	String	必填。长度32位，唯一
deptName	组织管理名称	String	必填。同一个层级的部门名称不能重复。长度限制为1~32个字符，字符不能包括:?”<>｜（唯一）
parentId	父节点	String	必填。32位长度，数字与字母组合。若当前传入部门没有父级部门，填-1
typeOnePersonIds	部门主管，传personId	List<String>	选填。
sortNum	排序序号	int	选填。序号范围：0~99
description	说明	String	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
​	"deptId":"8a8b8ac064ade4810164b12b8be88803",
​	"deptName":"测试部门",
​	"parentId":"-1",
​	"sortNum":"10",
​	"description":"测试部门"
}

返回参数用例：

{
    "code": 0,
    "data": 0,
    "msg": "保存成功"
}

修改部门

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/updateDept?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/updateDept?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/updateDept?token=（正式环境，token为企业凭证）

调用成果结果说明：

1、部门是建协云下的行政组织类型，不会加入企业自定义的组织类型。

入参说明：

请求参数	参数名	参数类型	说明
deptId	组织管理id	String	必填。长度32位，唯一
deptName	组织管理名称	String	必填。同一个层级的部门名称不能重复。长度限制为1~32个字符，字符不能包括:?”<>｜（唯一）
parentId	父节点	String	必填。32位长度，数字与字母组合。若当前传入部门没有父级部门，填-1
typeOnePersonIds	部门主管，传personId	List<String>	选填。如果为空，删除部门下所有主管
sortNum	排序序号	int	选填。序号范围：0~99
description	说明	String	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
  "deptId":"12321",
  "deptName":"办公室",
  "parentId":"-1",
  "sortNum":"2",
  "description":"人事、行政",
  "typeOnePersonIds": ["123213"]
}

返回参数用例：

{
  "code": 0,
  "status": 0,
  "data": null,
  "msg": "操作成功"
}

查询部门列表（不分页）

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/listDept?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/listDept?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/listDept?token=（正式环境，token为企业凭证）

调用成果结果说明：

1、部门是建协云下的行政组织类型，不会加入企业自定义的组织类型。

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Object
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
deptId	部门id	String
deptName	部门名称	String
deptCode	部门编号	String
organizationCode	组织类型编号	String
level	等级编号	String
state	状态	int	0：默认 1：可用 2：不可用
parentId	父节点Id	String
entId	企业id	String
organizationId	组织类型id	String
children	子部门	List
deptManagers	部门主管	List<deptManagers>

deptManagers中的字段：

返回参数	参数名	参数类型	说明
parentId	人员id	String
personName	人员姓名	String
deptId	所属部门id	String
sortNum	排序号	String
deptType	主管类型	String	1：部门主管。为保留字段

请求参数用例：

{
}

返回参数用例：

{
  "code": 0,
  "status": 0,
  "data": [
​    {
​      "deptId": "8a8b8ac064ade4810164b12052490012",
​      "deptName": "测试部门",
​      "deptCode": "ZZCODE00380",
​      "organizationCode": "xz_001",
​      "level": null,
​      "state": 1,
​      "parentId": "-1",
​      "organizationId": "34481b90b9d64bbc8127155256292ca1",
​	   "entId": "44a0800075",
​      "children": null,
​      "managementManagers": [
​        {
​          "personId": "02b6c84d1f0a449a8bd2495e432dd791",
​          "personName": "测试一号",
​          "managementId": "8a8b8ac064ade4810164b12052490012",
​          "sortNum": 0,
​          "managerType": 1,
​          "createTime": "2021-05-18T18:54:58",
​          "updateTime": ***\*null\****
​        }
​      ]
​    },
​      {
​      "deptId": "8a8b8ac064ade4810164b11e4ad2000c",
​      "deptName": "测试部门2",
​      "deptCode": "ZZCODE00410",
​      "organizationCode": "xz_001",
​      "level": null,
​      "state": 1,
​      "parentId": "-1",
​      "organizationId": "34481b90b9d64bbc8127155256292ca1",
​      "children": [
    ​        {
    ​          "deptId": "c1a972f553044c06b1321d99a497a05a",
    ​          "deptName": "子部门1",
    ​          "deptCode": "ZZCODE00001",
    ​          "organizationCode": null,
    ​          "level": null,
    ​          "state": 1,
    ​          "parentId": "8a8b8ac064ade4810164b11e4ad2000c",
    ​          "organizationId": "34481b90b9d64bbc8127155256292ca1",
    ​          "children": null,
    ​          "managementManagers": []
    ​        }
       ]
      "msg": "查询成功"
}

查询部门详情

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/getDeptDetails?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/getDeptDetails?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/getDeptDetails?token=（正式环境，token为企业凭证）

调用成果结果说明：

1、部门是建协云下的行政组织类型，不会加入企业自定义的组织类型。

入参说明：

请求参数	参数名	参数类型	说明
deptId	部门id	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
deptId	部门id	String
deptName	部门名称	String
deptCode	部门编号	String
organizationCode	组织类型编号	String
level	等级编号	String
state	状态	int	0：默认 1：可用 2：不可用
parentId	父节点Id	String
organizationId	组织类型id	String
entId	企业id	String
deptManagers	部门主管	List<deptManagers>

deptManagers中的字段：

返回参数	参数名	参数类型	说明
parentId	人员id	String
personName	人员姓名	String
deptId	所属部门id	String
sortNum	排序号	String
deptType	主管类型	String	1：部门主管。为保留字段

请求参数用例：

{
"deptId":"e2de441e0d941a9a0e89a67cb799a"
}

返回参数用例：

{
  "code": 0,
  "status": 0,
  "data": {
​    "deptId": "8a8b8ac064ade4810164b12052490012",
​    "deptName": "测试部门2",
​    "deptCode": "ZZCODE00380",
​    "organizationCode": "xz_001",
​    "level": ***\*null\****,
​    "state": 1,
​    "parentId": "-1",
​    "organizationId": "34481b90b9d64bbc8127155256292ca1",
​	 "entId": "44a0800075",
​    "managementManagers": [
    ​    {
    ​        "personId": "02b6c84d1f0a449a8bd2495e432dd791",
    ​        "personName": "测试1号",
    ​        "managementId": "8a8b8ac064ade4810164b12052490012",
    ​        "sortNum": 0,
    ​        "managerType": 1,
    ​        "createTime": "2021-05-18T18:54:58",
    ​        "updateTime": null
    ​    }
​    ]
  },
  "msg": "操作成功"
}

删除部门

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/deleteDept?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/deleteDept?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/deleteDept?token=（正式环境，token为企业凭证）

调用成果结果说明：

1、部门是建协云下的行政组织类型，不会加入企业自定义的组织类型。

入参说明：

请求参数	参数名	参数类型	说明
id	账号表主键id	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
​	"id":"e2de441e0d941a9a0e89a67cb799a"
}

返回参数用例：

{
  "code": 0
  "data": "",
  "msg": "删除成功"
}

校验用户是否存在

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/examineAccountExist?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/examineAccountExist?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/examineAccountExist?token=（正式环境，token为企业凭证）

调用成功结果返回：

1、该返回结果是代表人员是否已经在建协云有账号，非加入到企业。 2、校验条件互斥，优先级为：手机号、身份证号、账号。

入参说明：

请求参数	参数名	参数类型	说明
phone	手机号	String	选填。手机号、身份证号、账号传一个
idCard	身份证号	String	选填。手机号、身份证号、账号传一个
loginName	账号	String	选填。手机号、身份证号、账号传一个

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Boolean	true表示人员账号存在，false表示不存在
msg	返回说明	String

新增管理员

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/admin?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/admin?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/admin?token=（正式环境，token为企业凭证）

调用成功结果说明：

1、生成管理员账号。

2、绑定所有用户角色。

入参说明：

请求参数	参数名	参数类型	说明
unifiedcode	统一信用代码	String	必填。必须和企业凭证所属企业同一信用代码一致
adminName	管理员姓名	String	必填
adminLoginName	管理员账号	String	必填。管理员账号由数字、字母或“_-!@#$%^&*()=+;:”组成
adminPassword	管理员密码	String	必填。必须大于等于8位
systemCode	应用编号	String	必填
contactsPhone	管理员手机号	String	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
entId	企业id	String
adminAccountId	管理员账号ID	String
adminUcCode	管理员账号code	String

请求参数用例：

{	
	"adminName":"管理员",
	"unifiedcode":"",
	"adminLoginName":"12345678901",
	"adminPassword":"xxxxxxx",
	"systemCode":"JXY"
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": {
        "adminUcCode": "N29Y4Q",
        "adminAccountId": "492fafea9b6441309e17bb5ed517231b"
    },
    "msg": "操作成功"
}

新增管理员2 - 绑定管理员角色组

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/adminTow?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/adminTow?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/adminTow?token=（正式环境，token为企业凭证）

调用成功结果说明：

1、生成管理员账号。

2、绑定所有企业以关联的注册类型管理员组，跟建协云管理员。

入参说明：

请求参数	参数名	参数类型	说明
unifiedcode	统一信用代码	String	必填。必须和企业凭证所属企业同一信用代码一致
adminName	管理员姓名	String	必填
adminLoginName	管理员账号	String	必填。管理员账号由数字、字母或“_-!@#$%^&*()=+;:”组成
adminPassword	管理员密码	String	必填。必须大于等于8位
systemCode	应用编号	String	必填
contactsPhone	管理员手机号	String	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
entId	企业id	String
adminAccountId	管理员账号ID	String
adminUcCode	管理员账号code	String

请求参数用例：

{	
	"adminName":"管理员",
	"unifiedcode":"",
	"adminLoginName":"12345678901",
	"adminPassword":"xxxxxxx",
	"systemCode":"JXY"
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": {
        "adminUcCode": "N29Y4Q",
        "adminAccountId": "492fafea9b6441309e17bb5ed517231b"
    },
    "msg": "操作成功"
}

新增人员

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/person?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/person?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/person?token=（正式环境，token为企业凭证）

调用成功结果说明：

1、根据手机号校验是否已注册用户账号，已注册会自动忽略入参的登录账号，自动关联原有账号。

2、根据企业凭证将新增人员加入到所属企业中。

3、如果人员曾经入职过该企业，会重置其入职状态、重置角色为建协云普通员工、重置部门关联。

4、反参会返回用户最终的账号，如果账号和入参账号不相同，则说明是原来已有账号的用户。

5、副部们如果不存在，忽略加入部门

入参说明：

请求参数	参数名	参数类型	说明
name	姓名	String	必填。长度为1~50个utf8字符
phone	手机号	String	必填。11位纯数字，会校验是否已经有注册的手机号，如果有会关联已有用户，忽略新建的登录账号
loginName	登录账号	String	必填。字母与数字的组合且只包含字母与数字，少于18位，唯一
password	密码	String	必填。大于8位
mainDeptId	主部门id	String	必填。一个人只属于一个主部门
idCard	身份证号	String	选填。
gender	性别	String	选填。例：男
duty	职务	String	选填。长度为1~100个utf8字符
email	邮箱	String	选填
deptIds	副部门id列表	String	选填。一个人可以拥有多个不同的副部门，多个部门之间使用“,”隔开
systemCode	应用编码	String	选填。例ZHGD
salt	加密盐	String	选填
encryType	加密类型	int	选填。0：用户中心加密1：MD5+盐加密（适用施工资料、检测ERP）2：MD5加密大写
workNature	用工性质:1-试用2-正式3-实习4-特殊	Number	选填。默认2
roleGroupCodes	权限组编号列表	List	选填。

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Map	返回账号id
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
loginName	账号	String
accountCode	账号code	String
id	账号id	String

请求参数用例：

{
	"name": "何鲜生",
	"gender": "男",
	"idCard": "440183199305066547",
	"phone": "13524587777",
	"loginName": "hexiansheng3",
	"password": "abc12345678",
	"duty": "开发工程师",
	"email": "test123@12q.com",
	"mainDeptId": "9c866128fdb24fe29c155c699b7781bx",
	"deptIds": "9c866128fdb24fe29c155c699b7781b2",
	"systemCode": "PEARL",
	"salt": "123456789",
	"encryType": 0
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": {
        "accountCode": "8MON0D",
        "loginName": "hexiansheng2",
        "id": "1b72841bc0b14a428d80e4d5d2de500f"
    },
    "msg": "操作成功"
}

修改人员

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/updatePerson?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/updatePerson?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/updatePerson?token=（正式环境，token为企业凭证）

调用成功结果说明：

1、已填写的内容，会替换原人员信息，如不填写，则不会替换。

入参说明：

请求参数	参数名	参数类型	说明
id	账号表主键id	String	必填
name	姓名	String	选填
gender	性别	String	选填。“女”，“男”
idCard	身份证号	String	选填。身份证唯一，如已注册不可修改
phone	手机号	String	选填。11位纯数字，会校验其他账号是否已经有注册的手机号，如果有不可修改
email	邮箱	String	选填
personStatus	人员状态	String	选填。0-在职1-离职
dimissionDate	离职时间	String	选填。如人员状态设为离职生效
mainDeptId	主部门id	String	选填。人员在企业只能有一个主部门（建协云默认的行政组织），不填不改变
deptIds	所属部门id列表	String	选填。人员可以拥有多个不同的副部门，多个部门之间使用“,”隔开。不填不改变，填写后全替换
workNature	用工性质	Number	选填。1：试用，2：正式，3：实习，4：特殊

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
	"id": "1b72841bc0b14a428d80e4d5d2de500f",
	"name": "何子生",
	"sex": "男",
	"email": "test1234@xxx.com",
	"mainDeptId": "9c866128fdb24fe29c155c699b7781bx",
	"deptIds": "9c866128fdb24fe29c155c699b7781b2"
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": "",
    "msg": "操作成功"
}

查询人员列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/listPerson?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/listPerson?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/listPerson?token=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
page	页码	int	选填，默认1
limit	行数	int	选填，默认500
mainDeptId	主部门id	String	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
  "page": 1,
  "limit": 1,
  "mainDeptId": "402884e56e364c6b016e3a1f82af0673"
}

返回参数用例：

{
  "code": 0,
  "status": 0,
  "data": [
​    {
​      "id": "dfe6f95023b34e29b08501936a1a22a0",
​      "ucCode": "N6S621",
​      "personId":"313414134",
​      "name": "卢绍勇",
​      "gender": ***\*null\****,
​      "idCard": "450881199303085096",
​      "duty": ***\*null\****,
​      "personStatus": "0",
​      "email": ***\*null\****,
​      "mainDeptId": "402884e56e364c6b016e3a1f82af0673",
​      "deptIds": [],
​      "sortNum": "6",
​      "phone": "13602486309",
​      "loginname": "3h1526"
​    }
  ],
  "msg": "操作成功",
  "count": 443
}

查询人员

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/getPerson?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/getPerson?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/getPerson?token=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
phone	手机号	String	三选一
idcard	身份证	String	三选一
userId	用户id	String	三选一

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Object
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
id	用户主键

请求参数用例：

{
  "phone": ""
}

返回参数用例：

{
  "code": 0,
  "status": 0,
  "data": {
​    "id": "",
​    "personId":"",
​    "ucCode": "",
​    "name": "",
​    "gender": "",
​    "idCard": "",
​    "duty": "",
​    "personStatus": "0",
​    "email": "",
​    "mainDeptId": "",
​    "deptIds": [],
​    "sortNum": "0",
​    "phone": "13602486309",
​    "loginname": "3h1526"
  },
  "msg": "操作成功"
}

重置用户密码

入参说明

请求方式：POST/JSON

开发环境：http://192.168.0.220:5001/api/access/resetPassword?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/resetPassword?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/resetPassword?token=（正式环境，token为企业凭证）

入参说明：

请求字段	参数名	参数类型	说明
id	账号表主键id	String	必填
password	新密码	String	选填。（新密码应该为字母大小写、数字、特殊符号3者中两种组合，长度8-25位）为空则生成随机10位数密码

请求参数用例：

{
    "id": "000775ebd9064d359a2333ff153210c4",
    "password": ""
}

出参说明：

字段	参数名	参数类型	说明
code	返回码	int
data	返回数据	Map
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
password	用户密码	String	返回输入的密码；否则为随机10位数密码

返回参数用例：

{
    "code": 0,
    "status": 0,
    “data": {
        "password": "xJrXkrcoyF"
    },
    "msg": "修改成功"
}

修改用户密码

请求方式：POST/JSON 开发环境：http://192.168.0.220:5001/api/access/updatePassword?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/updatePassword?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/updatePassword?token=（正式环境，token为企业凭证）

入参说明：

请求字段	参数名	参数类型	字段说明
id	账号表主键id	String	必填
oldPassword	旧密码	String	必填
password	新密码	String	必填（新密码应该为字母大小写、数字、特殊符号3者中两种组合，长度8-25位）

请求参数用例：

{
    "id": "000775ebd9064d359a2333ff153210c4",
    "oldPassword": "xJrXkrcoyF",
    "password": "123456ABab"
}

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": null,
    "msg": "修改成功"
}

根据Ip,token,codes获取账号

请求方式：POST
开发环境：http://192.168.0.220:5001/api/sys-api/getIdAndCode?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/sys-api/getIdAndCode?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/sys-api/getIdAndCode?token=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
ip	ip地址	String	必填
codes	账号表code	String	必填传多个时使用,隔开

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	List
msg	返回说明	String

data中的字段：

返回参数	参数名	参数类型	说明
id	账号id	String
code	账号code	String
name	姓名	String

请求参数用例：

{
    "ip":"192.168.0.0",
    "codes":"U18RM,52118,Z8ZZC"
}

返回参数用例：

{
  "code": 0,
  "data": [
​    {
​      "id": "027142c43fe44e07a83656f297b5cb45",
​      "code": "U187RM",
​      "name": "测试人员"
​    },
​    {
​      "id": "04afe49f8c1611e887934ccc6a2b6335",
​      "code": "523118",
​      "name": "测试人员"
​    },
​    {
​      "id": "04afe6d78c1611e887934ccc6a2b6335",
​      "code": "Z8Z6ZC",
​      "name": "测试人员"
​    }
  ],
  "msg": "请求成功"
}

修改待办

请求方式：POST
开发环境：http://192.168.0.220:5001/other/backlog/updateItem?token= （220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/other/backlog/updateItem?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/other/backlog/updateItem?token=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	待办id	String	必填
groupId	分组ID	String	必填，不能修改
taskId	任务ID	String	必填，不能修改
type	类别	String	选填，例：采购申请，长度为1-32个字符
title	事项标题	String	选填，例：申请采购服务器，长度为1-32个字符
endTime	截止时间	String	选填，注：毫秒时间戳
ucCode	用户编码	String	选填，注：为6位长度，如3O386A
webUrl	Web详情页面链接	String	选填，例：https://www.3hmis.com 要带有https://,未尾没有”/”，长度最长为500个字符
appUrl	App详情页面链接	String	选填，例：https://www.3hmis.com 要带有https://,未尾没有”/”，长度最长为500个字符
webParams	Web详情页面链接参数	String	选填，例：id=123&name=tank，长为400个字符
appParams	App详情页面链接参数	String	选填，例：id=123&name=tank，长为400个字符
systemName	来源名称	String	选填，例：OA系统，长度为1-50个字符
systemCode	来源code	String	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	object
msg	返回说明	String

请求参数用例：

{
    "id": "001dd3baf37d454abb3877d62eee2dfe",
    "creatorCode": "62D045",
    "groupId": "300076",
    "taskId": "300083",
    "title": "123456789",
    "ucCode": "P3CVY6",
    "endTime": "1629767149763"
}

返回参数用例：

{
    "code": 0,
    "msg": "修改成功！",
    "data": {
        "id": "001dd3baf37d454abb3877d62eee2dfe",
        "type": null,
        "title": "123456789",
        "endTime": 1629767149763,
        "appUrl": null,
        "webUrl": null,
        "appParams": null,
        "webParams": null,
        "creatorCode": "62D045",
        "groupId": null,
        "taskId": null,
        "systemCode": null,
        "ucCode": "P3CVY6",
        "grade": 0
    }
}

将企业和多个应用的企业类型绑定

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/bindUnitTypes?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/bindUnitTypes?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/bindUnitTypes?token=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
unitId	企业id	String	必填
typeCodes	企业类型列表	List<String>	必填。typeCodes列表必须与systemCodes列表对应
systemCodes	应用编码列表	List<String>	必填。systemCodes列表必须与typeCodes列表对应

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据
msg	返回说明	String

请求参数用例：

{
    "unitId":"7f1128a7f632405ebf2331d5eb47a1c4",
    "typeCodes":["18","TYPE00151"],
    "systemCodes":["JXY","JIAO"]
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": null,
    "msg": "操作成功"
}

获取企业人员的考勤记录

请求方式：POST
开发环境：http://192.168.0.220:5001/api/clockIn/queryClockInRecordByDay?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/clockIn/queryClockInRecordByDay?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/clockIn/queryClockInRecordByDay?token=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
date	日期	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	List
msg	返回说明	String

data中的参数说明：

返回参数	参数名	参数类型	说明
startTime	上班打卡时间	String
endTime	下班打卡时间	String
status	打卡状态	int	状态 0-异常 1-正常
statusList	考勤状态	List	0-正常 1-旷工 2-休息 3-休息并打卡 4-迟到 5-早退 6-上班缺卡 7-下班缺卡 8-外出 9-出差 10-请假 11-补上班卡 12-补下班卡
ucName	姓名	String
depName	部门名称	String
unitId	企业id	String
ucId	账号id	String

请求参数用例：

{
    "date": "2021-12-01"
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": [
        {
            "startTime": "2021-12-01 10:00",
            "endTime": null,
            "status": 0,
            "statusList": [
                1,11
            ],
            "ucName": "湖南建工",
            "depName": "测试",
            "unitId": "bdf3da8ed4704e2794175dc5b702a356",
            "ucId": "2a1c1ef2d80b462cbc8625e720f6b4b1"
        }
    ],
    "msg": "操作成功"
}

获取人员实名认证信息

请求方式：POST
开发环境：http://192.168.0.220:5001/system/ai/getAuthCardByPersonId?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/system/ai/getAuthCardByPersonId?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/system/ai/getAuthCardByPersonId?token=（建协云正式环境，token为企业凭证）
黑龙江生产环境：http://219.147.76.5:7833/system/ai/getAuthCardByPersonId?token=（黑龙江正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
basePersonId	基础人员主键(和personId两个必填一个)	String
personId	企业人员主键(和basePersonId两个必填一个)	String

出参说明：

参数名	参数类型	参数描述
code	Integer	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	Integer	响应状态
data	Array	返回数据
data.accountId	String	账号id
data.idCard	String	人员身份证号
data.nation	String	民族
data.realName	String	人员名称
data.address	String	身份证地址
data.birthday	String	生日
data.sex	String	性别
data.frontPath	String	身份证正面图片
data.backPath	String	身份证背面图片
data.headPath	String	头部图片
data.signOrg	String	发证机关
data.expiryDate	String	证件有效期
data.facePath	String	人脸图片
data.faceScore	Double	相似度
data.status	Integer	数据状态：0未认证；1已认证（审核通过）；2审核中
data.failCount	Integer	人脸识别失败次数
data.createTime	TimeStamp	认证时间（取消认证后重新认证的时候，会重置这个时间）
msg	String	返回文字描述

请求参数用例：

{
    "basePersonId":"xxxxx",
    "personId":"xxxx"
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": {
		"accountId": "04afe6dxxxxxc6a2b6335",
		"idCard": "440xxxx996",
		"nation": "汉",
		"realName": "李xx威",
		"address": "广东xxxxxx号",
		"birthday": "1xxx926",
		"sex": "男",
		"frontPath": "/root/hhh/3huc/idcard/04afe6d78_1.jpg",
		"backPath": "/root/hhh/3huc/idcard/04afe6d78_2.jpg",
		"headPath": "/root/hhh/3huc/idcard/04afe6d78_3.jpg",
		"signOrg": "xx市xxx局",
		"expiryDate": "20250605",
		"facePath": "/root/hhh/3huc/idcard/04afe6d_4.jpg",
		"faceScore": 94.4683609,
		"status": 1,
		"failCount": 0,
		"createTime": "2021-01-22 19:13:30"
	},
	"msg": "操作成功"
}

工程更新监督状态

请求方式：POST
开发环境：http://192.168.0.220:5001/system/project/updateSection?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/system/project/updateSection?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/system/project/updateSection?token=（建协云正式环境，token为企业凭证）
黑龙江生产环境：http://219.147.76.5:7833/system/project/updateSection?token=（黑龙江正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	工程表主键	String	数据主键从数据中台同步
startDate	开工日期(实际)	TimeStamp	格式 : yyyy-MM-dd HH:mm:ss
endDate	竣工日期(实际)	TimeStamp	格式 : yyyy-MM-dd HH:mm:ss
constructPart	施工部位	String
sectionNum	安全质量监督号	String
aqSectionNum	安全监督号	String
zlSectionNum	质量监督号	String
sectionXxjd	形象进度	String	房建(101 开工前准备,102 基坑阶段,103 地基基础,104 地下结构,105 主体结构,106 封顶,107 装饰装修,108 建筑设备安装,109 完工,110 停工);市政(201 开工前准备,202 基坑阶段,203 盾构（暗挖）施工,204 地基基础,205 地下结构,206 主体结构,207 封顶,208 装饰装修,209 建筑设备安装,210 铺轨,211 完工,212 停工)
statusAq	安全工程状态	String	01 未开工工程,02 在建工程,03 停工工程,04 完工待验收（或安全评价）工程,05 未验收投入使用,06 已验收(或安全评价)工程,07 已验收未备案,08 已竣工验收备案,09 开工前准备
statusZl	质量工程状态	String	和 statusAq 状态一样
monitorStatus	监督状态	String	01 在监,02 中止,03 终止
sectionStatus	工程状态	String	和 statusAq 状态一样

出参说明：

参数名	参数类型	参数描述
code	Integer	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	Integer	响应状态
data	Array	返回数据
msg	String	返回文字描述

请求参数用例：

{
    "id":"121xxxx4545646",
    "startDate":"2019-01-22 19:13:30",
    "endDate":"2021-01-22 19:13:30",
    "constructPart":"基坑",
    "sectionNum":"155xxx123",
    "aqSectionNum":"155xxx123",
    "zlSectionNum":"xxxxx",
    "sectionXxjd":"210",
    "statusAq":"02",
    "statusZl":"02",
    "monitorStatus":"01",
    "sectionStatus":"02"
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": null,
	"msg": "操作成功"
}

工程更新开工前条件审查通过

请求方式：POST
开发环境：http://192.168.0.220:5001/system/project/updateStatus?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/system/project/updateStatus?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/system/project/updateStatus?token=（建协云正式环境，token为企业凭证）
黑龙江生产环境：http://219.147.76.5:7833/system/project/updateStatus?token=（黑龙江正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	工程表主键	String	数据主键从数据中台同步
status	数据状态	Integer	开工前条件审核通过 2

出参说明：

参数名	参数类型	参数描述
code	Integer	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	Integer	响应状态
data	Array	返回数据
msg	String	返回文字描述

请求参数用例：

{
    "id":"121xxxx4545646",
    "status":2
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": null,
	"msg": "操作成功"
}

新增或更新单位工程与监督站关联关系

请求方式：POST
开发环境：http://192.168.0.220:5001/system/project/saveBatchProjectUnitCompany?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/system/project/saveBatchProjectUnitCompany?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/system/project/saveBatchProjectUnitCompany?token=（建协云正式环境，token为企业凭证）
黑龙江生产环境：http://219.147.76.5:7833/system/project/saveBatchProjectUnitCompany?token=（黑龙江正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	单位工程与单位关联表主键	String	数据主键从数据中台(manager_section_company)同步
sectionId	工程主键	String
sectionCode	单位工程编码	String	预留字段(后续内部对接可以考虑该字段),该字段目前可能会没值
unitId	单位主键	String
unitName	单位名称	String
unifiedcode	统一社会信用代码	String
unitType	单位类型	String	1001 安全监督站(省);1002安全监督站(市);1003安全监督站(区);1011质量监督站(省);1012质量监督站(市);1013质量监督站(区);1021质量安全监督站(省);1022质量安全监督站(市);1023质量安全监督站(区)
unitTypeExtend	承建类型	Integer	主管单位数据默认给 0即可,0-主要承包 1-次要承包
createTime	创建时间	TimeStamp	格式 : yyyy-MM-dd HH:mm:ss
updateTime	更新时间	TimeStamp	格式 : yyyy-MM-dd HH:mm:ss
invalid	是否删除	Integer	0-否 1-是

出参说明：

参数名	参数类型	参数描述
code	Integer	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	Integer	响应状态
data	boolean	返回数据
msg	String	返回文字描述

请求参数用例：

{
	data:[{
		"id":"54564654sadas",
		"sectionId":"1456654sasss",
		"sectionCode": "2145",
		"unitId": "24564sdfsdr",
		"unitName": "单位名称",
		"unifiedcode": "1ss24xxx",
		"unitType": "1001",
		"unitTypeExtend": 0,
		"createTime": "2019-01-22 19:13:30",
		"updateTime": "2019-01-22 19:13:30",
		"invalid": 0
	}]
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": true,
	"msg": "操作成功"
}

新增或更新单位工程与监督员关联关系

请求方式：POST
开发环境：http://192.168.0.220:5001/system/project/saveBatchProjectUnitPerson?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/system/project/saveBatchProjectUnitPerson?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/system/project/saveBatchProjectUnitPerson?token=（建协云正式环境，token为企业凭证）
黑龙江生产环境：http://219.147.76.5:7833/system/project/saveBatchProjectUnitPerson?token=（黑龙江正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	单位工程与人员关联表主键	String	数据主键从数据中台(manager_section_person)同步
sectionId	工程主键	String
sectionCode	单位工程编码	String	预留字段(后续内部对接可以考虑该字段),该字段目前可能会没值
unitId	单位主键	String
unitType	单位类型	String	1001 安全监督站(省);1002安全监督站(市);1003安全监督站(区);1011质量监督站(省);1012质量监督站(市);1013质量监督站(区);1021质量安全监督站(省);1022质量安全监督站(市);1023质量安全监督站(区)
personId	单位人员主键	String	企业人员表(unit_person)的主键
personName	人员名称	String
personPhone	人员手机号	String
createTime	创建时间	TimeStamp	格式 : yyyy-MM-dd HH:mm:ss
updateTime	更新时间	TimeStamp	格式 : yyyy-MM-dd HH:mm:ss
invalid	是否删除	Integer	0-否 1-是

出参说明：

参数名	参数类型	参数描述
code	Integer	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	Integer	响应状态
data	boolean	返回数据
msg	String	返回文字描述

请求参数用例：

{
	data:[{
		"id":"54564654sadas",
		"sectionId":"1456654sasss",
		"sectionCode": "2145",
		"unitId": "24564sdfsdr",
		"unitType": "1001",
		"personId": "4s5d465ad4",
		"personName": "测试",
		"personPhone": "13078446266",
		"createTime": "2019-01-22 19:13:30",
		"updateTime": "2019-01-22 19:13:30",
		"invalid": 0
	}]
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": true,
	"msg": "操作成功"
}

新增或更新单位工程与监督科室关联关系

请求方式：POST
开发环境：http://192.168.0.220:5001/system/project/saveBatchDeptPermission?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/system/project/saveBatchDeptPermission?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/system/project/saveBatchDeptPermission?token=（建协云正式环境，token为企业凭证）
黑龙江生产环境：http://219.147.76.5:7833/system/project/saveBatchDeptPermission?token=（黑龙江正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	单位工程与人员关联表主键	String	数据主键从数据中台(manager_section_person)同步
sectionId	工程主键	String
unitId	单位主键	String
deptId	科室主键	String
deptName	科室名称	String
personId	人员主键	String
sourceType	数据来源类型	Integer	(默认给 2 监督系统)
updateTime	更新时间	TimeStamp	格式 : yyyy-MM-dd HH:mm:ss
invalid	是否删除	Integer	0-否 1-是

出参说明：

参数名	参数类型	参数描述
code	Integer	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	Integer	响应状态
data	boolean	返回数据
msg	String	返回文字描述

请求参数用例：

{
	data:[{
		"id":"54564654sadas",
		"sectionId":"1456654sasss",
		"unitId": "2145",
		"deptId": "24564sdfsdr",
		"deptName": "测试",
		"personId": "4s5d465ad4",
		"sourceType": 2,
		"updateTime": "2019-01-22 19:13:30",
		"invalid": 0
	}]
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": true,
	"msg": "操作成功"
}

新增或更新危大工程完善状态

请求方式：POST
开发环境：http://192.168.0.220:5001/system/project/saveBatchPerfectionStatus?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/system/project/saveBatchPerfectionStatus?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/system/project/saveBatchPerfectionStatus?token=（建协云正式环境，token为企业凭证）
黑龙江生产环境：http://219.147.76.5:7833/system/project/saveBatchPerfectionStatus?token=（黑龙江正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	主键	String
sectionId	工程主键	String
perfectionType	完善类型	Integer	3 危大工程,监督传这个类型即可
status	状态	Integer	0 未完善; 1 已完善
updateTime	更新时间	TimeStamp	格式 : yyyy-MM-dd HH:mm:ss

出参说明：

参数名	参数类型	参数描述
code	Integer	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	Integer	响应状态
data	Array	返回数据
msg	String	返回文字描述

请求参数用例：

{
	"data":[{
		"id":"54564654sadas",
		"sectionId":"1456654sasss",
		"perfectionType": 3,
		"status": 1,
		"updateTime": "2019-01-22 19:13:30"
	}]
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": [{
		"id":"54564654sadas",
		"sectionId":"1456654sasss",
		"perfectionType": 3,
		"status": 1,
		"updateTime": "2019-01-22 19:13:30"
	}],
	"msg": "操作成功"
}

设备列表

请求方式：POST
开发环境：http://192.168.0.220:5001/system/project/deviceList?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/system/project/deviceList?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/system/project/deviceList?token=（建协云正式环境，token为企业凭证）
黑龙江生产环境：http://219.147.76.5:7833/system/project/deviceList?token=（黑龙江正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
deviceCode	主键	String	设备编号
limit	工程主键	int
page	完善类型	int

出参说明：

参数名	参数类型	参数描述
code	int	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	int	响应状态
data	map	返回数据
msg	String	返回文字描述
count	int	总数

data参数说明：

参数名	参数类型	参数描述
id	String	设备id
deviceCode	String	设备编号
productId	String	所属产品id
productCode	String	所属产品编号
productName	String	所属产品名称
productKey	String	所属产品key
unitId	String	企业id
unitName	String	企业名称
disable	int	是否禁用。1：正常；2：禁用
auditStatus	int	审核状态。0：保存；1：审核中；2：审核通过；3：不通过
usedAddress	String	设备使用地址
sectionId	String	单位工程ID
sectionCode	String	工程编号
sectionName	String	工程名称
address	String	工程地址
licenceNum	String	施工许可证编号
subjectId	String	项目id
subjectName	String	项目名称

请求参数用例：

{
    "limit": 10,
    "page": 1,
    "deviceCode": ""
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": [
		{
			"sectionId": null,
			"licenceNum": null,
			"subjectId": null,
			"subjectName": null,
			"sectionCode": null,
			"sectionName": null,
			"address": null,
			"id": "cdb8f7dfa4884ce99e9905e04eecd4b5",
			"deviceCode": "设备号001",
			"productId": "0697fedcf7ad49b98ebdf31b4efc5842",
			"productName": "电动梁式起重机csc",
			"productCode": "DDC",
			"productKey": "2d489f7cad3143a0943f87b859089d5a",
			"unitId": "44a0800075",
			"unitName": "广州粤建三和软件股份有限公司",
			"disable": 1,
			"auditStatus": 2,
			"usedAddress": "朝阳小区202"
		},
		{
			"sectionId": "4bc3a4440083474faf69372d46605b43",
			"licenceNum": "1233",
			"subjectId": null,
			"subjectName": null,
			"sectionCode": "123456",
			"sectionName": "12333",
			"address": null,
			"id": "80b50d10252b4f94a82bc8abe2fc983e",
			"deviceCode": "设备号02",
			"productId": "0697fedcf7ad49b98ebdf31b4efc5842",
			"productName": "电动梁式起重机csc",
			"productCode": "DDC",
			"productKey": "2d489f7cad3143a0943f87b859089d5a",
			"unitId": "44a0800075",
			"unitName": "广州粤建三和软件股份有限公司",
			"disable": 1,
			"auditStatus": 2,
			"usedAddress": "重庆小区"
		}
	],
	"msg": "操作成功",
	"count": 2
}

设备绑定单位工程

请求方式：POST
开发环境：http://192.168.0.220:5001/system/project/bindProject?token=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/system/project/bindProject?token=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/system/project/bindProject?token=（建协云正式环境，token为企业凭证）
黑龙江生产环境：http://219.147.76.5:7833/system/project/bindProject?token=（黑龙江正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
sectionId	单位工程id	String
deviceId	设备id	String
flag	是否绑定	int	0绑定 1解绑

出参说明：

参数名	参数类型	参数描述
code	int	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	int	响应状态
data	boolean	返回数据
msg	String	返回文字描述

请求参数用例：

{
    "sectionId": "4bc3a4440083474faf69372d46605b43", //单位工程id
    "deviceId": "cdb8f7dfa4884ce99e9905e04eecd4b5", //设备id
    "flag": 0 // 0绑定 1解绑
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": true,
    "msg": "操作成功"
}

应用级接口

获取应用详情

注：查询到的应用为：移动端应用

请求方式：GET
开发环境：http://192.168.0.220:5001/api/access/getAgent?token=&agentId=（220，token为企业凭证）
测试环境：http://zt.3hmis.com:30010/api/access/getAgent?token=&agentId=（测试环境，token为企业凭证）
生产环境：https://m.jianxiecloud.com/api/access/getAgent?token=&agentId=（正式环境，token为企业凭证）

入参说明：

请求参数	参数名	参数类型	说明
token	应用凭证	String
agentId	应用id	String

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String
data中的数据
agentId	应用id	String
appName	应用名称	String
agentSecret	应用密钥	String
status	应用状态	Number

请求参数用例：

{
}

返回参数用例：

{
  "code": 0,
  "status": 0,
  "data": {
​    "agentId": "0ed93728afdf43e09b9ed73457062ace",
​    "appName": "其它",
​    "agentSecret": "f4290335e8484b4faf5b1378d1a4dd06",
​    "status": 1
  },
  "msg": "查询成功"
}

获取应用的企业类型列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/applical/listType?token=（220，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/applical/listType?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/applical/listType?token=（正式环境，token为应用凭证）

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	List	类型名称：typeName，类型Code：typeCode
msg	返回说明	String

请求参数用例：

{
}

返回参数用例：

{
  "code": 0,
  "data": [
        {
            "typeName":"测试类型03",
            "typeCode":"TYPE00018"
        }...
    ]
  "msg": "success"
}

将企业和应用的企业类型绑定

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/bindUnitType?token=（220，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/access/bindUnitType?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/access/bindUnitType?token=（正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
unitId	企业id	String	必填
typeCode	企业类型	String	必填
isHome	是否将应用社会企业主页(0-否，1-是)	Number	选填
systemCode	当前应用系统标识	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	List	类型名称：typeName，类型Code：typeCode
msg	返回说明	String

请求参数用例：

{
  "unitId":"f20f8af17d674ee68411ffa14cff3ac8",
  "typeCode":"TYPE00052",
  "systemCode":"COOB-ZHONGSHAN"
}

返回参数用例：

{
    "code": 1,
    "status": 1,
    "data": null,
    "msg": "操作成功"
}

客户端发送监控数据给服务器

请求方式：POST
开发环境：http://192.168.0.220:5001/canary-api/monitor/monitorData?token=（220，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/canary-api/monitor/monitorData?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/canary-api/monitor/monitorData?token=（正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
clientCode	发送端编号	String	必填
companyName	单位名称	String	必填
clientTime	客户端时间	String	必填
customerId	企业标识	String
errorNum	异常总数	Integer
notSendNum	未上传总数	Integer

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Map
msg	返回说明	String

请求参数用例：

{
    "clientCode":"2222222221111111111111111111",
    "companyName":"ssssssssssssssssssssssssssaaaaaassss",
    "clientTime":"2021-03-25 13:23:00",
    "customerId":"wwwwwwww",
    "errorNum":0,
    "notSendNum":0
}

返回参数用例：

{
  "code": 0,
  "status": 0,
  "data": null,
  "msg": "success"
}

为账号绑定某应用下的管理员角色

请求方式：POST
开发环境：http://192.168.0.220:5001/api/access/bindAdminPersonType?token=（220，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/access/bindAdminPersonType?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/access/bindAdminPersonType?token=（正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
unifiedcode	账号所属企业的统一社会信用代码	String	必填
loginName	被绑定账号	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Object
msg	返回说明	String

请求参数用例：

{
    "unifiedcode":"91440106716305360L",
    "loginName":"3h8888"
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": null,
    "msg": "操作成功"
}

获取工程信息总完善状态

请求方式：POST
开发环境：http://192.168.0.220:5001/system/project/getPerfectionStatus（220环境）
测试环境：http://zt.3hmis.com:30010/system/project/getPerfectionStatus（测试环境）
生产环境：https://m.jianxiecloud.com/system/project/getPerfectionStatus（建协云正式环境）
黑龙江生产环境：http://219.147.76.5:7833/system/project/getPerfectionStatus（黑龙江正式环境）

入参说明：

请求参数	参数名	参数类型	说明
sectionId	工程主键	String
agentId	应用id	String
agentSecret	应用秘钥	String

出参说明：

参数名	参数类型	参数描述
code	Integer	返回code（0表示请求成功，具体参考建协云开发者中心文档编码）
status	Integer	响应状态
data	Integer	返回数据 ( 0存在未完善项; 1开工前准备资料已齐全)
msg	String	返回文字描述

请求参数用例：

{
	"sectionId":"12345646651454654",
	"agentId":"45645645644",
	"agentSecret":"112312156123"
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": 0,
	"msg": "存在未完善项!"
}

项目列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/listSubject?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/listSubject?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/listSubject?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/listSubject?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
page	当前页码	int	默认1
limit	当前条数	int	默认10
provinceSubjectCode	省级项目编号	String	精确查询
subjectName	项目名称	String	精确查询
updateTime	更新时间	String	格式 : yyyy-MM-dd
startTime	更新开始时间	String	格式 : yyyy-MM-dd
endTime	更新结束时间	String	格式 : yyyy-MM-dd

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	项目ID	String
subjectCode	项目编号	String
subjectName	项目名称	String
subjectGenus	项目类型(大类)	String
subjectType	项目类型(小类)	String
buildType	建设性质	String
provinceSubjectCode	省级项目编号	String
provinceCode	所在省编号	String
cityCode	所在市编号	String
areaCode	所在区县编号	String
townCode	所属街道编号	String
licence	立项批文(证书编号)	String
amount	投资预算（万元）	decimal
approvalLevel	立项级别	String
approvalDepart	立项批复机关	String
approvalDate	立项批复时间	datetime
allLength	总长度/米	decimal
address	建设地点详情	String
startDate	计划开工日期	datetime
endDate	计划竣工日期	datetime
area	建筑面积	decimal
structType	结构类型	String
fundSource	资金来源	String
remark	备注信息	String
status	状态	int	数据状态 0-保存 1-已提交 2-审核通过 3-退回
invalid	是否已删除	int	0 正常;1 已删除

请求参数用例：

{
    "page":"1",
    "limit":"1",
    "provinceSubjectCode":"",
    "subjectName":"",
    "updateTime":"",
    "startTime":"",
    "endTime":""
}

返回参数用例：

{
    {
    "code": 0,
    "status": 0,
    "data": [
        {
            "id": "71f4ded0d08f4afbbbfe404c0eb257f3",
            "subjectCode": "",
            "subjectName": "12",
            "subjectGenus": "",
            "subjectType": null,
            "buildType": "",
            "provinceCode": "",
            "cityCode": "",
            "areaCode": "",
            "townCode": "",
            "licence": "",
            "amount": null,
            "approvalLevel": "",
            "approvalDepart": "",
            "approvalDate": null,
            "allLength": null,
            "address": null,
            "startDate": null,
            "endDate": null,
            "area": null,
            "remark": "",
            "status": 0,
            "creatorId": null,
            "creatorName": null,
            "createTime": null,
            "updatorId": null,
            "updatorName": null,
            "updateTime": null,
            "invalid": 0,
            "systemCode": null,
            "structType": null,
            "fundSource": null,
            "provinceSubjectCode": null,
            "origin": null
        }
    ],
    "msg": "操作成功",
    "count": 46254
}
}

项目企业关联关系列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/listSubjectCompany?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/listSubjectCompany?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/listSubjectCompany?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/listSubjectCompany?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
page	当前页码	int	默认1
limit	当前条数	int	默认10
subjectId	项目主键	String
updateTime	更新时间	String	格式 : yyyy-MM-dd
startTime	更新开始时间	String	格式 : yyyy-MM-dd
endTime	更新结束时间	String	格式 : yyyy-MM-dd

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	主键	String
subjectId	项目id	String
unitId	企业主键	String
unitName	企业名称	String
unifiedcode	统一社会信用代码	String
unitType	企业类型	String
unitTypeExtend	承建类型	int	0 主要承包;1 次要承包;2 劳务分包
invalid	是否已删除	int	0 正常;1 已删除

请求参数用例：

{
	"page": "1",
	"limit": "1",
	"subjectId": "",
	"updateTime": "",
	"startTime": "",
	"endTime": ""
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": [
		{
			"id": "71f4ded0d08f4afbbbfe404c0eb257f3",
			"subjectId": "71f4ded0d08f4afbbbfe404c0eb257f3",
			"unitId": null,
			"unitName": "",
			"unifiedcode": null,
			"unitType": "8",
			"unitTypeExtend": 0,
			"createTime": "2022-04-07T16:05:59",
			"updateTime": "2022-04-07T16:05:59",
			"invalid": 0
		}
	],
	"msg": "操作成功",
	"count": 2
}

项目人员关联关系列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/listSubjectPerson?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/listSubjectPerson?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/listSubjectPerson?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/listSubjectPerson?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
page	当前页码	int	默认1
limit	当前条数	int	默认10
subjectId	项目主键	String
updateTime	更新时间	String	格式 : yyyy-MM-dd
startTime	更新开始时间	String	格式 : yyyy-MM-dd
endTime	更新结束时间	String	格式 : yyyy-MM-dd

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	主键	String
subjectId	项目id	String
unitId	企业主键	String
personId	人员id	String
personName	人员名称	String
personPhone	手机号码	String
invalid	是否已删除	int	0 正常;1 已删除

请求参数用例：

{
	"page": "1",
	"limit": "1",
	"subjectId": "",
	"updateTime": "",
	"startTime": "",
	"endTime": ""
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": [
		{
			"id": "36137556782b4bf2937423da018a1cc3",
			"subjectId": "36137556782b4bf2937423da018a1cc3",
			"unitId": "000ffcb547284fdab8d414ece8c8886d",
			"personId": "0ea7d070f175425f8b519b5ebd56d6f2",
			"personName": "广东鸿利泰建筑工程有限公司管理员",
			"personPhone": null,
			"createTime": "2022-03-07T14:26:52",
			"updateTime": "2022-03-07T14:26:52",
			"invalid": 0
		}
	],
	"msg": "操作成功",
	"count": 1
}

单项项目列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/listPeriod?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/listPeriod?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/listPeriod?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/listPeriod?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
page	当前页码	int	默认1
limit	当前条数	int	默认10
subjectId	项目主键	String
updateTime	更新时间	String	格式 : yyyy-MM-dd
startTime	更新开始时间	String	格式 : yyyy-MM-dd
endTime	更新结束时间	String	格式 : yyyy-MM-dd

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	主键	String
subjectId	项目id	String
periodCode	单项工程编码	String
periodName	单项工程名称	String
certificateNum	工程规划许可证号	String
certificateAgency	发证机关	String
certificateDate	发证时间	datetime
buildSize	建设规模	String
invalid	是否已删除	int	0 正常;1 已删除

请求参数用例：

{
	"page": "1",
	"limit": "1",
	"subjectId": "",
	"updateTime": "",
	"startTime": "",
	"endTime": ""
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": [
		{
			"id": "e17a2a334a2c4823a15e9de2790ee317",
			"subjectId": "440d50fb41c111ecae370800270054fd",
			"periodCode": "",
			"periodName": "111",
			"certificateNum": "",
			"certificateAgency": "",
			"certificateDate": null,
			"buildSize": "",
			"creatorId": "8dc558e9c0624df8a1325d07670e6d49",
			"creatorName": "杨小坤",
			"createTime": "2022-04-06T14:02:17",
			"updatorId": "8dc558e9c0624df8a1325d07670e6d49",
			"updatorName": "杨小坤",
			"updateTime": "2022-04-06T14:02:31",
			"invalid": 1,
			"systemCode": null
		}
	],
	"msg": "操作成功",
	"count": 33
}

施工许可列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/listSectionPermit?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/listSectionPermit?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/listSectionPermit?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/listSectionPermit?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
page	当前页码	int	默认1
limit	当前条数	int	默认10
licenceNum	施工许可证号	String
updateTime	更新时间	String	格式 : yyyy-MM-dd
startTime	更新开始时间	String	格式 : yyyy-MM-dd
endTime	更新结束时间	String	格式 : yyyy-MM-dd

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	施工许可证id	String
sectionId	单位工程id	String
licenceNum	施工许可证编号	String
certificateAgency	施工许可证发证机关	String
certificateDate	施工许可证发证日期	datetime
invalid	是否已删除	int	0 正常;1 已删除

请求参数用例：

{
	"page": "1",
	"limit": "1",
	"licenceNum": "",
	"updateTime": "",
	"startTime": "",
	"endTime": ""
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": [
		{
			"id": "4d377daa9485430f909397286f1a85ec",
			"sectionId": "4d377daa9485430f909397286f1a85ec",
			"licenceNum": "20",
			"certificateAgency": null,
			"certificateDate": null,
			"contractStartDate": null,
			"contractEndDate": null,
			"licenceBook": null,
			"licenceCopyBook": null,
			"permitStatus": null,
			"remark": null,
			"creatorId": "8dc558e9c0624df8a1325d07670e6d49",
			"creatorName": "杨小坤（搬砖工）",
			"createTime": "2022-08-03T18:34:59",
			"updatorId": "8dc558e9c0624df8a1325d07670e6d49",
			"updatorName": "杨小坤（搬砖工）",
			"updateTime": "2022-08-03T18:34:59",
			"invalid": 0,
			"systemCode": null,
			"contractDuration": null,
			"origin": null
		}
	],
	"msg": "操作成功",
	"count": 3497
}

单位工程列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/listSection?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/listSection?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/listSection?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/listSection?token=（黑龙江正式环境，token为应用凭证）

说明: 数据为已审核通过数据

入参说明：

请求参数	参数名	参数类型	说明
page	当前页码	int	默认1
limit	当前条数	int	默认10
licenceNum	施工许可证号	String	精确查询
sectionName	工程名称	String	精确查询
updateTime	更新时间	String	格式 : yyyy-MM-dd
startTime	更新开始时间	String	格式 : yyyy-MM-dd
endTime	更新结束时间	String	格式 : yyyy-MM-dd

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	单位工程id	String
subjectId	项目id	String
periodId	单项工程ID	String
bidId	标段id	String
sectionCode	单位工程编码	String
sectionName	单位工程名称	String
address	单位工程地址	String
sectionGenus	单位工程类型(大类)	String
sectionType	单位工程类型(小类)	String
provinceCode	所在省编号	String
cityCode	所在市编号	String
areaCode	所在区县编号	String
townCode	所属街道编号	String
sectionCost	总投资额(万元)	decimal
area	总面积(m²)	decimal
gpsX	X坐标	String
gpsY	Y坐标	String
sectionScale	建设规模	String
allLength	总长度/米	decimal
prefabricated	是否装配式	int	0 否;1 是
defense	是否人防工程	int	0 否;1 是
apartments	是否全装修商品住宅	int	0 否;1 是
superHighRise	是否超高层	int	0 否;1 是
planStartDate	计划开工日期	datetime
planEndDate	计划竣工日期	datetime
startDate	(实际)开工日期	datetime
endDate	(实际)竣工日期	datetime
contractCost	合同价/万元	decimal
reportDate	提交日期	datetime
constructPart	施工部位	String
sectionNum	安全质量监督号	String
aqSectionNum	安全监督号	String
zlSectionNum	质量监督号	String
sectionXxjd	形象进度	String
statusAq	安全工程状态	String
statusZl	质量工程状态	String
monitorStatus	监督状态	String
sectionStatus	工程状态	String
remark	备注信息	String
invalid	是否已删除	int	0 正常;1 已删除

请求参数用例：

{
	"page": "1",
	"limit": "1",
	"licenceNum": "",
	"sectionName": "",
	"updateTime": "",
	"startTime": "",
	"endTime": ""
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": [
		{
			"id": "4d377daa9485430f909397286f1a85ec",
			"subjectId": null,
			"periodId": "",
			"sectionCode": null,
			"sectionName": "测试20",
			"address": "广东省广州市白云区",
			"sectionGenus": "01",
			"sectionType": null,
			"provinceCode": "340000000000",
			"cityCode": "340800000000",
			"areaCode": "340871000000",
			"townCode": null,
			"sectionCost": 0,
			"area": 0,
			"gpsX": "113.244216",
			"gpsY": "23.236027",
			"sectionScale": "11",
			"allLength": 0,
			"prefabricated": 0,
			"defense": 0,
			"apartments": 0,
			"superHighRise": 0,
			"planStartDate": "2022-08-03T00:00:00",
			"planEndDate": "2022-08-02T00:00:00",
			"startDate": null,
			"endDate": null,
			"contractCost": null,
			"reportDate": "2022-08-04T10:11:11",
			"constructPart": null,
			"sectionNum": null,
			"aqSectionNum": null,
			"zlSectionNum": null,
			"sectionXxjd": null,
			"monitorStatus": null,
			"sectionStatus": null,
			"statusAq": null,
			"statusZl": "01",
			"status": 1,
			"remark": null,
			"creatorId": "8dc558e9c0624df8a1325d07670e6d49",
			"creatorName": "杨小坤（搬砖工）",
			"createTime": "2022-08-03T18:34:59",
			"updatorId": "2120f54568cd496fb32d235dd41b40e8",
			"updatorName": "党丽怡",
			"updateTime": "2022-08-04T10:11:11",
			"invalid": 0,
			"systemCode": null,
			"bidId": null,
			"consolidationPersonId": null,
			"consolidationPerson": null,
			"consolidationTime": null,
			"earlyIntervention": 0,
			"origin": null,
			"earlyInterventionView": 0
		}
	],
	"msg": "操作成功",
	"count": 4496
}

修改单位工程

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/updateSection?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/updateSection?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/updateSection?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/updateSection?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	单位工程主键	String	必填
address	单位工程地址	String
sectionCost	总投资额(万元)	decimal(13,2)
area	总面积(m²)	decimal(13,2)
sectionScale	建设规模	String
allLength	总长度(m)	decimal(13,2)
gpsX	X坐标	String
gpsY	Y坐标	String
startDate	(实际)开工日期	datetime
endDate	(实际)竣工日期	datetime
constructPart	施工部位	String
sectionNum	安全质量监督号	String
aqSectionNum	安全监督号	String
zlSectionNum	质量监督号	String	存sectionNum的时候,也需要存该字段
sectionXxjd	形象进度	String
statusAq	安全工程状态	String
statusZl	质量工程状态	String
monitorStatus	监督状态	String
sectionStatus	工程状态	String
remark	备注信息	String

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
	"id": "0012bd17-de18-4d89-9040-9663dec4929f",
	"address": "湖南省长沙市天心区芙蓉南路826号",
	"sectionCost": "",
	"area": "",
	"sectionScale": "",
	"allLength": "",
	"gpsX": "",
	"gpsY": "",
	"startDate": "",
	"endDate": "",
	"constructPart": "",
	"sectionNum": "",
	"aqSectionNum": "",
	"zlSectionNum": "",
	"sectionXxjd": "",
	"statusAq": "",
	"statusZl": "",
	"monitorStatus": "",
	"sectionStatus": "",
	"remark": "",
	"sectionNum": ""
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": {
		"id": "0012bd17-de18-4d89-9040-9663dec4929f",
		"subjectId": "440d463241c111ecae370800270054fd",
		"periodId": "7ca0dda6-42c8-11ec-b088-5cf3fc4966ca",
		"sectionCode": "43010020180319003",
		"sectionName": "碧桂园·滨江府",
		"address": "湖南省长沙市天心区芙蓉南路826号",
		"sectionGenus": "01",
		"sectionType": "100",
		"provinceCode": "430000000000",
		"cityCode": "430100000000",
		"areaCode": "430124000000",
		"townCode": null,
		"sectionCost": 0,
		"area": null,
		"gpsX": "",
		"gpsY": "",
		"sectionScale": "",
		"allLength": null,
		"prefabricated": null,
		"defense": null,
		"apartments": null,
		"superHighRise": null,
		"planStartDate": null,
		"planEndDate": null,
		"startDate": null,
		"endDate": null,
		"contractCost": null,
		"reportDate": null,
		"constructPart": null,
		"sectionNum": null,
		"aqSectionNum": null,
		"zlSectionNum": null,
		"sectionXxjd": "xxjd_fj_03",
		"monitorStatus": null,
		"sectionStatus": "02",
		"statusAq": "02",
		"statusZl": "01",
		"status": 1,
		"remark": null,
		"creatorId": null,
		"creatorName": null,
		"createTime": "2018-03-19T11:45:53",
		"updatorId": "2c6c250ab84c45c8b6dfac2578287ced",
		"updatorName": null,
		"updateTime": "2021-12-11T13:56:06",
		"invalid": 0,
		"systemCode": null,
		"bidId": "007",
		"consolidationPersonId": null,
		"consolidationPerson": null,
		"consolidationTime": null,
		"earlyIntervention": 0,
		"origin": null,
		"earlyInterventionView": 0
	},
	"msg": "操作成功"
}

审核单位工程

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/aduitSection?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/aduitSection?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/aduitSection?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/aduitSection?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	单位工程主键	String	必填
status	数据状态	int	必填 2审核通过 3退回

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
	"id": "004e7967143355bca9b17f4469f2e0c7",
	"status": 2
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": {
		"id": "004e7967143355bca9b17f4469f2e0c7",
		"status": 2
	},
	"msg": "操作成功"
}

合并提前介入与施工许可工程

请求方式：POST
请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/consolidationProject?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/consolidationProject?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/consolidationProject?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/consolidationProject?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
sectionId	施工许可工程id	String	必填
oldSectionId	提前介入工程id	String	必填
operatorId	操作人账号ID	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Object
msg	返回说明	String

请求参数用例：

{
	"sectionId": "00bec0c1-f354-4b15-a582-8d8da23ce5ef",
	"oldSectionId": "38b6cdaa287645a3944ce5eab2eff8f4",
	"operatorId":"402884e5734d66ab0173569b8e9c1335"
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": {
		"id": "38b6cdaa287645a3944ce5eab2eff8f4",
		"subjectId": "440d50fb41c111ecae370800270054fd",
		"periodId": "7ca0e9af-42c8-11ec-b088-5cf3fc4966ca",
		"sectionCode": "43010020180918001",
		"sectionName": "金科集美天辰一期",
		"address": "湖南省长沙市岳麓区府中路",
		"sectionGenus": "01",
		"sectionType": "100",
		"provinceCode": "430000000000",
		"cityCode": "430100000000",
		"areaCode": "430101000000",
		"townCode": null,
		"sectionCost": 0,
		"area": 110000,
		"gpsX": "112.941787",
		"gpsY": "28.23445",
		"sectionScale": "1",
		"allLength": 1,
		"prefabricated": 0,
		"defense": 0,
		"apartments": 0,
		"superHighRise": 0,
		"planStartDate": "2022-03-01T00:00:00",
		"planEndDate": "2026-04-23T00:00:00",
		"startDate": null,
		"endDate": null,
		"contractCost": 0,
		"reportDate": "2022-04-15T16:42:42",
		"constructPart": null,
		"sectionNum": null,
		"aqSectionNum": null,
		"zlSectionNum": "123",
		"sectionXxjd": "107",
		"monitorStatus": null,
		"sectionStatus": "02",
		"statusAq": "02",
		"statusZl": "02",
		"status": 1,
		"remark": null,
		"creatorId": null,
		"creatorName": null,
		"createTime": null,
		"updatorId": "402884e5734d66ab0173569b8e9c1335",
		"updatorName": "刘坚",
		"updateTime": "2022-08-04T11:08:31.234",
		"invalid": 0,
		"systemCode": null,
		"bidId": null,
		"consolidationPersonId": "402884e5734d66ab0173569b8e9c1335",
		"consolidationPerson": "刘坚",
		"consolidationTime": "2022-08-04T11:08:31.234",
		"earlyIntervention": 0,
		"origin": null,
		"earlyInterventionView": 1
	},
	"msg": "操作成功"
}

单位工程企业关联关系列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/listSectionCompany?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/listSectionCompany?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/listSectionCompany?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/listSectionCompany?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
page	当前页码	int	默认1
limit	当前条数	int	默认10
sectionId	单位工程主键	String
licenceNum	施工许可证号	String	精确查询
updateTime	更新时间	String	格式 : yyyy-MM-dd
startTime	更新开始时间	String	格式 : yyyy-MM-dd
endTime	更新结束时间	String	格式 : yyyy-MM-dd

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	主键	String
sectionId	单位工程id	String
sectionCode	单位工程编码	String
unitId	企业主键	String
unitName	企业名称	String
unifiedcode	统一社会信用代码	String
unitType	企业类型	String
unitTypeExtend	承建类型	int	0 主要承包;1 次要承包;2 劳务分包
aptitudeId	资质主键	String
invalid	是否已删除	int	0 正常;1 已删除

请求参数用例：

{
    "sectionId":"24c059dda832ssssss71026cfa91",
    "oldSectionId":"1172308edsssss0ba5752d556f3"
}

返回参数用例：

{
    "code": 0,
    "data": null,
    "msg": "操作成功"
}

新增单位工程企业关联关系

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/saveSectionCompany?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/saveSectionCompany?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/saveSectionCompany?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/saveSectionCompany?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
sectionId	单位工程主键	String	必填
sectionCode	单位工程编码	String
unitId	企业id	String	必填
unitName	企业名称	String
unifiedcode	统一社会信用代码	String
unitType	企业类型	String	必填
unitTypeExtend	承建类型	int	0 主要承包; 1 次要承包; 2劳务分包
aptitudeId	资质主键	String

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Object
msg	返回说明	String
data中的数据
id	主键	String	返回新增后的主键
sectionId	单位工程主键	String
sectionCode	单位工程编码	String
unitId	企业id	String
unitName	企业名称	String
unifiedcode	统一社会信用代码	String
unitType	企业类型	String
unitTypeExtend	承建类型	int
aptitudeId	资质主键	String

请求参数用例：

{
	"sectionId": "00bec0c1-f354-4b15-a582-8d8da23ce5ef",
	"sectionCode": "43010020180918001",
	"unitId":"44a0800075",
	"unitName":"广州粤建三和软件股份有限公司",
	"unifiedcode":"91440106716305360L",
	"unitType":"3",
	"unitTypeExtend":0,
	"aptitudeId":""
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": {
		"id": "b8f87da10e3749f282df2e85e491d109",
		"sectionId": "00bec0c1-f354-4b15-a582-8d8da23ce5ef",
		"sectionCode": "43010020180918001",
		"unitId": "44a0800075",
		"unitName": "广州粤建三和软件股份有限公司",
		"unifiedcode": "91440106716305360L",
		"unitType": "3",
		"unitTypeExtend": 0,
		"aptitudeId": "",
		"createTime": "2022-08-04T11:16:10.444",
		"updateTime": "2022-08-04T11:16:10.444",
		"invalid": null,
		"origin": null
	},
	"msg": "操作成功"
}

修改单位工程企业关联关系

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/updateSectionCompany?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/updateSectionCompany?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/updateSectionCompany?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/updateSectionCompany?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	主键	String	必填
sectionId	单位工程主键	String	必填
sectionCode	单位工程编码	String
unitId	企业id	String	必填
unitType	企业类型	String	必填
unitTypeExtend	承建类型	int	0 主要承包; 1 次要承包; 2劳务分包
aptitudeId	资质主键	String

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
    "sectionId":"24c059dda832ssssss71026cfa91",
    "oldSectionId":"1172308edsssss0ba5752d556f3"
}

返回参数用例：

{
    "code": 0,
    "data": null,
    "msg": "操作成功"
}

删除单位工程企业关联关系

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/delSectionCompany?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/delSectionCompany?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/delSectionCompany?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/delSectionCompany?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	主键	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
	"id": "f4291ef4144e479190659ba709ecf386"
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": null,
	"msg": "操作成功"
}

单位工程人员关联关系列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/listSectionPerson?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/listSectionPerson?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/listSectionPerson?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/listSectionPerson?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
page	当前页码	int	默认1
limit	当前条数	int	默认10
sectionId	单位工程主键	String
licenceNum	施工许可证号	String	精确查询
updateTime	更新时间	String	格式 : yyyy-MM-dd
startTime	更新开始时间	String	格式 : yyyy-MM-dd
endTime	更新结束时间	String	格式 : yyyy-MM-dd

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	主键	String
sectionId	单位工程id	String
sectionCode	单位工程编码	String
unitId	企业主键	String
unitType	企业类型	String
personId	人员id	String
personName	人员名称	String
personPhone	手机号码	String
personCertId	人员证书主键	String
duty	职务	String
lockStatus	人员锁定状态	int	0-未锁定 1-已锁定
pledgeStatus	人员押证状态	int	0-未押证 1-已押证
invalid	是否已删除	int	0 正常;1 已删除

请求参数用例：

{
	"page": "1",
	"limit": "1",
	"sectionId": "",
	"licenceNum": "",
	"updateTime": "",
	"startTime": "",
	"endTime": ""
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": [
		{
			"id": "0633868e17b14c1a9b8d8274608efda9",
			"sectionId": "a38268c6a10e4f43bbdb36c8fef272c8",
			"sectionCode": "",
			"unitId": "44a0800075",
			"unitType": "pt_001",
			"personId": "074637657c004ea699138654d8cb02fe",
			"personName": "高晗",
			"personPhone": null,
			"personCertId": null,
			"duty": "1001",
			"lockStatus": null,
			"pledgeStatus": null,
			"createTime": "2022-07-25T17:07:32",
			"updateTime": "2022-07-25T17:07:32",
			"invalid": 0,
			"origin": null,
			"originDate": "2022-07-25T17:07:30",
			"isPledge": null
		}
	],
	"msg": "操作成功",
	"count": 6308
}

新增单位工程人员关联关系

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/saveSectionPerson?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/saveSectionPerson?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/saveSectionPerson?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/saveSectionPerson?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
sectionId	单位工程主键	String	必填
sectionCode	单位工程编码	String
unitId	企业id	String	必填
unitType	企业类型	String	必填
personId	人员主键	String	必填
personCertId	人员证书主键	String
duty	职务	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Object
msg	返回说明	String
data中的数据
id	主键	String	返回新增后的主键
sectionId	单位工程主键	String	必填
sectionCode	单位工程编码	String
unitId	企业id	String	必填
unitType	企业类型	String	必填
personId	人员主键	String	必填
personName	人员名称	String
personPhone	人员手机号	String
personCertId	人员证书主键	String
duty	职务	String	必填

请求参数用例：

{
	"sectionId": "00bec0c1-f354-4b15-a582-8d8da23ce5ef",
	"sectionCode": "43010020180918001",
	"unitType":"3",
	"unitId":"44a0800075",
	"personId":"3b3689a674c8483588bdb042845d689f",
	"personCertId":"",
	"duty":"0307"
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": {
		"id": "d4f8c595346a4c0daad2c6b10a089372",
		"sectionId": "00bec0c1-f354-4b15-a582-8d8da23ce5ef",
		"sectionCode": "43010020180918001",
		"unitId": "44a0800075",
		"unitType": "3",
		"personId": "3b3689a674c8483588bdb042845d689f",
		"personName": "吴林林",
		"personPhone": "13078436240",
		"personCertId": "",
		"duty": "0307",
		"lockStatus": null,
		"pledgeStatus": null,
		"createTime": "2022-08-04T14:19:05.416",
		"updateTime": "2022-08-04T14:19:05.416",
		"invalid": null,
		"origin": null,
		"originDate": null,
		"isPledge": null
	},
	"msg": "操作成功"
}

修改单位工程人员关联关系

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/updateSectionPerson?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/updateSectionPerson?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/updateSectionPerson?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/updateSectionPerson?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	主键	String	必填
sectionId	单位工程主键	String	必填
sectionCode	单位工程编码	String
unitId	企业id	String	必填
unitType	企业类型	String	必填
personId	人员主键	String	必填
personName	人员名称	String
personPhone	人员手机号	String
personCertId	人员证书主键	String
duty	职务	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
	"id":"812675cbcfca44ad98db4d4b43766065",
	"sectionId": "00bec0c1-f354-4b15-a582-8d8da23ce5ef",
	"sectionCode": "43010020180918001",
	"unitType":"3",
	"unitId":"44a0800075",
	"personId":"c5a2b1295b7f4e648d4bbcda71f66e36",
	"personCertId":"",
	"duty":"0307"
}

返回参数用例：

{
	"id":"812675cbcfca44ad98db4d4b43766065",
	"sectionId": "00bec0c1-f354-4b15-a582-8d8da23ce5ef",
	"sectionCode": "43010020180918001",
	"unitType":"3",
	"unitId":"44a0800075",
	"personId":"c5a2b1295b7f4e648d4bbcda71f66e36",
	"personCertId":"",
	"duty":"0307"
}

删除单位工程人员关联关系

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/delSectionPerson?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/delSectionPerson?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/delSectionPerson?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/delSectionPerson?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	主键	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
	"id":"812675cbcfca44ad98db4d4b43766065"
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": null,
	"msg": "操作成功"
}

单体工程列表

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/listProject?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/listProject?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/listProject?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/listProject?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
page	当前页码	int	默认1
limit	当前条数	int	默认10
updateTime	更新时间	String	格式 : yyyy-MM-dd
startTime	更新开始时间	String	格式 : yyyy-MM-dd
endTime	更新结束时间	String	格式 : yyyy-MM-dd

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	单体工程主键	String
periodId	单项工程id	String
sectionId	单位工程id	String
sectionPermitId	施工许可id	String
projectCode	单体工程编码	String
projectName	单体工程名称	String
type	工程类型	String
projectXxjd	形象进度	String
buildNo	自然栋号	String
structuralType	结构体系	String
buildingHeight	建筑高度	String
floors	总层数	String
upFloors	地上层数	String
downFloors	底下层数	String
buildArea	建筑面积	String
plannedUse	规划用途	String
basicForm	基础形式	String
remark	备注	String
invalid	是否已删除	int	0 正常;1 已删除

请求参数用例：

{
	"page": "1",
	"limit": "1",
	"updateTime": "",//更新时间
	"startTime": "",//更新开始时间
	"endTime": ""//更新结束时间
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": [
		{
			"id": "a1707ad848ea4b5b82f35d76771e9743",
			"subjectId": null,
			"periodCode": null,
			"periodName": null,
			"certificateNum": null,
			"certificateAgency": null,
			"certificateDate": null,
			"buildSize": null,
			"creatorId": "8dc558e9c0624df8a1325d07670e6d49",
			"creatorName": "杨小坤",
			"createTime": "2022-04-06T11:58:14",
			"updatorId": "8dc558e9c0624df8a1325d07670e6d49",
			"updatorName": "杨小坤",
			"updateTime": "2022-04-06T13:51:07",
			"invalid": 0,
			"systemCode": null
		}
	],
	"msg": "操作成功",
	"count": 13
}

新增单体工程

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/saveProject?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/saveProject?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/saveProject?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/saveProject?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
periodId	单项工程id	String
sectionId	单位工程id	String
sectionPermitId	施工许可id	String
projectCode	单体工程编码	String
projectName	单体工程名称	String	必填
type	工程类型	String
projectXxjd	形象进度	String
buildNo	自然栋号	String
structuralType	结构体系	String
buildingHeight	建筑高度	String
floors	总层数	String
upFloors	地上层数	String
downFloors	底下层数	String
buildArea	建筑面积	String
plannedUse	规划用途	String
basicForm	基础形式	String
remark	备注	String

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Array
msg	返回说明	String
data中的数据
id	单体工程主键	String
periodId	单项工程id	String
sectionId	单位工程id	String
sectionPermitId	施工许可id	String
projectCode	单体工程编码	String
projectName	单体工程名称	String
type	工程类型	String
projectXxjd	形象进度	String
buildNo	自然栋号	String
structuralType	结构体系	String
buildingHeight	建筑高度	String
floors	总层数	String
upFloors	地上层数	String
downFloors	底下层数	String
buildArea	建筑面积	String
plannedUse	规划用途	String
basicForm	基础形式	String
remark	备注	String

请求参数用例：

{
    "sectionId":"24c059dda832ssssss71026cfa91",
    "oldSectionId":"1172308edsssss0ba5752d556f3"
}

返回参数用例：

{
    "code": 0,
    "data": null,
    "msg": "操作成功"
}

修改单体工程

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/updateProject?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/updateProject?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/updateProject?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/updateProject?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	单体工程主键	String	必填
periodId	单项工程id	String
sectionId	单位工程id	String
sectionPermitId	施工许可id	String
projectCode	单体工程编码	String
projectName	单体工程名称	String	必填
type	工程类型	String
projectXxjd	形象进度	String
buildNo	自然栋号	String
structuralType	结构体系	String
buildingHeight	建筑高度	String
floors	总层数	String
upFloors	地上层数	String
downFloors	底下层数	String
buildArea	建筑面积	String
plannedUse	规划用途	String
basicForm	基础形式	String
remark	备注	String

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
    "sectionId":"24c059dda832ssssss71026cfa91",
    "oldSectionId":"1172308edsssss0ba5752d556f3"
}

返回参数用例：

{
    "code": 0,
    "data": null,
    "msg": "操作成功"
}

删除单体工程

请求方式：POST
开发环境：http://192.168.0.220:5001/api/project/delProject?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/project/delProject?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/project/delProject?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://219.147.76.5:7833/api/project/delProject?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
id	单体工程主键	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String
msg	返回说明	String

请求参数用例：

{
	"id":"3ceb804181bb41068453f0ed567a4ebb"
}

返回参数用例：

{
	"code": 0,
	"status": 0,
	"data": null,
	"msg": "操作成功"
}

推送预警

请求方式：POST
开发环境：http://192.168.0.220:5001/api/earlyWarningRecord/save?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/earlyWarningRecord/save?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/earlyWarningRecord/save?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://111.40.190.81:30020/api/earlyWarningRecord/save?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
warningProjectCode	预警项目编码	String	必填
sectionCode	工程编码	String	必填
earlyWarningContent	预警内容	String	必填
appUrl	app跳转地址	String	选填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	String	预警记录id
msg	返回说明	String

请求参数用例：

{
    "warningProjectCode": "LB0001",
    "sectionCode": "430191202201060085",
    "earlyWarningContent": "xx工程名称出现扬尘x色报警，扬尘设备设备名称监测到pm2.5达到xx ug/m³,pm10达到xx ug/m³,请您及时处理现场问题，并在平台登记处理情况。",
    "appUrl": ""
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": "d17e6d8e48ab45fdb5c43fd7465ab61c",
    "msg": "操作成功"
}

消警

请求方式：POST
开发环境：http://192.168.0.220:5001/api/earlyWarningRecord/dispose?token=（220环境，token为应用凭证）
测试环境：http://zt.3hmis.com:30010/api/earlyWarningRecord/dispose?token=（测试环境，token为应用凭证）
生产环境：https://m.jianxiecloud.com/api/earlyWarningRecord/dispose?token=（建协云正式环境，token为应用凭证）
黑龙江生产环境：http://111.40.190.81:30020/api/earlyWarningRecord/dispose?token=（黑龙江正式环境，token为应用凭证）

入参说明：

请求参数	参数名	参数类型	说明
recordIds	预警记录id列表	List	必填
cancelWarningContent	消警内容	String	必填
ucId	账号id	String	必填
unitId	企业id	String	必填
ucName	企业名称	String	必填

出参说明：

返回参数	参数名	参数类型	说明
code	返回码	int
data	返回数据	Boolen
msg	返回说明	String

请求参数用例：

{
    "recordIds": ["d17e6d8e48ab45fdb5c43fd7465ab61c"],
    "cancelWarningContent": "消警",
    "ucId": "a249d5642552420081f247fd78c0a6f5",
    "unitId": "2a1c1ef2d80b462cbc8625e720f6b4b1",
    "unitName": "湖南建工控股集团有限公司"
}

返回参数用例：

{
    "code": 0,
    "status": 0,
    "data": true,
    "msg": "操作成功"
}

#