# 统一用户请求应用接口

# 同步|账号

# 基本信息

用途说明：统一用户平台向下游应用系统同步|账号数据

请求方式：POST

请求流向：统一用户平台->服务总线->下游应用系统

接口地址：各应用系统自己拟定

# 请求方式

请求头：Content-Type=application/json

请求体：

参数字段	必填	字段类型	字段名称	示例
Request	是	Object
Data	是	List
operation	是	String	操作类型（update：新增或修改；delete：删除）
id	是	String	开放平台主键id
loginName	是	String	登录名（例：ys01）	ys01
name	是	String	账号名称（例：医生01）	医生01
personId	是	String	人员唯一标识码
accountOrgCode	是	String	行政部门所属机构
activity	拓展字段	Boolean	账号是否启用 true/false	true
startDate	拓展字段	Date	账号生效日期，格式：yyyy-MM-dd	2022-09-30
endDate	拓展字段	Date	账号失效日期，格式：yyyy-MM-dd	2023-09-29
pyCode	拓展字段	String	账号拼音码
wbCode	拓展字段	String	账号五笔码
mark	拓展字段	String	账号备注
seqNo	拓展字段	Integer	账号排序
password	拓展字段	String	账号密码
personName	拓展字段	String	人员姓名
personBeforeName	拓展字段	String	人员曾用名
personGenderCode	拓展字段	String	人员性别编码	见附录
personGenderName	拓展字段	String	人员性别名称
personBirthDate	拓展字段	String	人员出生日期，格式：yyyy-MM-dd	1980-03-02
personBirthTime	拓展字段	String	人员出生时间，格式：HH:mm:ss	16:13:15
personCountryCode	拓展字段	String	人员国籍编码
personCountryName	拓展字段	String	人员国籍名称
personIdentityId	拓展字段	String	人员证件号码
personIdentityType	拓展字段	String	人员身份证件类型	见附录
personIdentityName	拓展字段	String	人员身份证件类型名称
personNationCode	拓展字段	String	人员民族编码	见附录
personNationName	拓展字段	String	人员民族名称
personEducationCode	拓展字段	String	人员学历编码	见附录
personEducationName	拓展字段	String	人员学历名称
personOccupationCode	拓展字段	String	人员职业编码	见附录
personOccupationName	拓展字段	String	人员职业名称
personMarriedCode	拓展字段	String	人员婚姻状态编码	见附录
personMarriedName	拓展字段	String	人员婚姻状态名称
personReligionCode	拓展字段	String	人员宗教编码	见附录
personReligionName	拓展字段	String	人员宗教名称
personNpCountryCode	拓展字段	String	人员籍贯（国家）编码
personNpCountryName	拓展字段	String	人员籍贯（国家）名称
personNpProvCode	拓展字段	String	人员籍贯（省）编码
personNpProvName	拓展字段	String	人员籍贯（省）名称
personNpCityCode	拓展字段	String	人员籍贯（市）编码
personNpCityName	拓展字段	String	人员籍贯（市）名称
personNpDistrCode	拓展字段	String	人员籍贯（县区）编码
personNpDistrName	拓展字段	String	人员籍贯（县区）名称
personAddrCountryCode	拓展字段	String	人员现住址（国家）编码
personAddrCountryName	拓展字段	String	人员现住址（国家）名称
personAddrProvCode	拓展字段	String	人员现住址（省）编码
personAddrProvName	拓展字段	String	人员现住址（省）名称
personAddrCityCode	拓展字段	String	人员现住址（市）编码
personAddrCityName	拓展字段	String	人员现住址（市）名称
personAddrDistrCode	拓展字段	String	人员现住址（县区）编码
personAddrDistrName	拓展字段	String	人员现住址（县区）名称
personAddress	拓展字段	String	人员现住址（详细地址）
personPhoto	拓展字段	String	人员照片
personMobile	拓展字段	String	人员手机号码
personStatus	拓展字段	String	人员状态编码	见附录
personStatusName	拓展字段	String	人员状态名称
personIsActivity	拓展字段	Boolean	人员启用状态 true-启用 false-停用	1
personStartDate	拓展字段	Date	人员生效日期，格式：yyyy-MM-dd	2022-03-02
personEndDate	拓展字段	Date	人员失效日期，格式：yyyy-MM-dd	2023-03-01
personPyCode	拓展字段	String	人员拼音码
personWbCode	拓展字段	String	人员五笔码
personMark	拓展字段	String	人员备注
personDegreeCode	拓展字段	String	人员学位编码	见附录
personDegreeName	拓展字段	String	人员学位名称
personMail	拓展字段	String	人员邮箱
deptList	拓展字段	List《String》	人员部门岗职角色信息列表(全量数据)
--deptCode	拓展字段	String	所属部门编码
--adminFlag	拓展字段	Boolean	是否为行政归属部门
--orgCode	拓展字段	String	人员机构编码
--personCode	拓展字段	String	人员工号
--personOrgStartDate	拓展字段	Date	人员机构生效日期，格式：yyyy-MM-dd	2022-03-02
--personOrgEndDate	拓展字段	Date	人员机构失效日期，格式：yyyy-MM-dd	2023-03-01
--personOrgActivity	拓展字段	Boolean	人员机构启用状态 true-启用 false-停用	true
--positionList	拓展字段	List《String》	人员职位列表
----positionCode	拓展字段	String	组织职位编码
----positionName	拓展字段	String	组织职位名称
----positionDictCode	拓展字段	String	职位字典编码
----positionDictName	拓展字段	String	职位字典名称
----personPositionStartDate	拓展字段	Date	人员职位生效日期，格式：yyyy-MM-dd	2022-03-02
----personPositionEndDate	拓展字段	Date	人员职位失效日期，格式：yyyy-MM-dd	2023-03-01
----personPositionActivity	拓展字段	Boolean	人员职位启用状态 true-启用 false-停用	true
--profList	拓展字段	List《String》	人员职务列表
----profCode	拓展字段	String	组织职务编码
----profName	拓展字段	String	组织职务名称
----profDictCode	拓展字段	String	职务字典编码
----profDictName	拓展字段	String	职务字典名称
----personProfStartDate	拓展字段	Date	人员职务生效日期，格式：yyyy-MM-dd	2022-03-02
----personProfEndDate	拓展字段	Date	人员职务失效日期，格式：yyyy-MM-dd	2023-03-01
----personProfActivity	拓展字段	Boolean	人员职务启用状态 true-启用 false-停用	true
--postList	拓展字段	List《String》	人员业务岗位对象集合
----postCode	拓展字段	String	业务岗位编码
----postName	拓展字段	String	业务岗位名称
----buCode	拓展字段	String	业务单元编码
----buName	拓展字段	String	业务单元名称
----postDictCode	拓展字段	String	岗位字典编码
----postDictName	拓展字段	String	岗位字典名称
----personPostStartDate	拓展字段	Date	人员岗位生效日期，格式：yyyy-MM-dd	2022-03-02
----personPostEndDate	拓展字段	Date	人员岗位失效日期，格式：yyyy-MM-dd	2023-03-01
----personPostActivity	拓展字段	Boolean	人员岗位启用状态 true-启用 false-停用	true
----roleCodes	拓展字段	List《String》	岗位绑定角色编码集合

# 请求结构示例


{
    "Request":{
        "Data":[
            {
                "operation":"update",
                "id":"940f36630cd57557a2183175b87156e2",
                "loginName":"zhangsirui",
                "name":"张思瑞",
                "activity":true,
                "startDate":"2022-09-05",
                "endDate":null,
                "pyCode":"ZSR",
                "wbCode":"xxx",
                "seqNo":1,
                "mark":"a",
                "password":"$2a$10$pS8CIQrp2IgRcmuYThDPB.kEUyGdpOUDfnk2LaAVh.pbGC4sFauVW",
                "personId":"xx001",
                "mobile":"13011111111",
                "gender":"男",
                "identityId":"110101198010243212",
                "mail":"123456@163.com",
                "title":"主任医师",
                "personStatus":"在职",
                "accountOrgCode":"xx001",
                "deptList":[
                    {
                        "deptCode":"ZYZY003",
                        "adminFlag":true,
                        "orgCode":"xx001",
                        "positionCodes":[
                            "NFMKZRYS",
                            "NFMKHS"
                        ],
                        "profCodes":[
                            "ZR",
                            "FZR"
                        ],
                        "postList":[
                            {"postCode":"POST001",
                            "buCode":"bu002",
                            "roleCodes":["role001","role002"]}
                        ]
                    },
                    {
                        "deptCode":"ZYZY006",
                        "adminFlag":false,
                        "orgCode":"xx002",
                         "positionCodes":[
                            "NFMKZRYS",
                            "NFMKHS"
                        ],
                        "profCodes":[
                            "ZR",
                            "FZR"
                        ],
                        "postList":[
                            {"postCode":"POST001",
                            "buCode":"bu001",
                            "roleCodes":["role001","role002"]}
                        ]
                    }
                ]
            },
            {
                "operation":"update",
                "id":"0e82ba213a53f64bd85f641da065e2d8",
                "loginName":"wangfeifei",
                "name":"王菲菲",
                "activity":true,
                "startDate":"2022-09-05",
                "endDate":"2023-09-04",
                "pyCode":"WFF",
                "wbCode":"xxx",
                "seqNo":2,
                "mark":"ffff",
                "password":"$2a$10$pS8CIQrp2IgRcmuYThDPB.kEUyGdpOUDfnk2LaAVh.pbGC4sFauVW",
                "personId":"xx002",
                "mobile":"13022222222",
                "gender":"女",
                "identityId":"110101196704173233",
                "mail":"6543234@163.com",
                "title":"医师",
                "personStatus":"在职",
                "accountOrgCode":"xx003",
                "deptList":[
                    {
                        "deptCode":"ZYZY003",
                        "adminFlag":true,
                        "orgCode":"xx003",
                        "positionCodes":[
                            "NFMKZRYS",
                            "NFMKHS"
                        ],
                        "profCodes":[
                            "ZR",
                            "FZR"
                        ],
                        "postList":[
                            {"postCode":"POST002",
                            "buCode":"bu002",
                            "roleCodes":["role003","role004"]}
                        ]
                    },
                    {
                        "deptCode":"ZYZY006",
                        "adminFlag":false,
                        "orgCode":"xx002",
                        "positionCodes":[
                            "NFMKZRYS",
                            "NFMKHS"
                        ],
                        "profCodes":[
                            "ZR",
                            "FZR"
                        ],
                        "postList":[
                            {"postCode":"POST003",
                            "buCode":"bu003",
                            "roleCodes":["role005","role006"]}
                        ]
                    }
                ]
            }
        ]
    }
}

# 返回参数

参数字段	必填	字段类型	字段名称	示例
code	是	String	响应状态	200-成功 201-部分失败其他-全部失败
msg	否	String	错误信息
data	是	List	同步成功的统一用户平台账号id集合

# 返回结构示例

{
    "code":"200",
    "msg":"success",
    "data":[
        "940f36630cd57557a2183175b87156e2",
        "0e82ba213a53f64bd85f641da065e2d8"
    ]
}

# 同步角色

# 基本信息

用途说明：统一用户平台向下游应用系统同步角色数据

请求方式：POST

请求流向：统一用户平台->服务总线->下游应用系统

接口地址：各应用系统自己拟定

# 请求方式

请求头：Content-Type=application/json

请求体：

参数字段	必填	字段类型	字段名称	示例
Request	是	Object
Data	是	List
operation	是	String	操作类型（update：新增或修改；delete：删除）
id	是	String	统一用户平台角色id
code	是	String	角色编码
name	是	String	角色名称
parentCode	是	String	父角色编码，当为0时表示当前角色为顶级角色，没有父角色
activity	是	Boolean	是否启用	true/false
startDate		String	生效日期，格式：yyyy-MM-dd	2022-10-01
endDate		String	失效日期，格式：yyyy-MM-dd	2023-09-30
pyCode		String	拼音码
wbCode		String	五笔码
mark		String	备注
seqNo		Integer	排序值
orgCode		String	机构编码

# 请求结构示例

{
    "Request":{
        "Data":[
            {
                "operation":"update",
                "id":"b4bfd76565b9dee9c88c51aa57ccb053",
                "code":"53453",
                "name":"测试",
                "parentCode":"0",
                "activity":true,
                "startDate":"2022-09-05",
                "endDate":null,
                "pyCode":null,
                "wbCode":null,
                "seqNo":null,
                "mark":"a",
                "orgCode":"1111"
            }
        ]
    }
}

# 返回参数

参数字段	必填	字段类型	字段名称	示例
code	是	String	响应状态	200-成功 201-部分失败其他-全部失败
msg	否	String	错误信息
data	是	List	同步成功的统一用户平台角色id集合

# 返回结构示例

{
    "code":"200",
    "msg":"success",
    "data":[
        "940f36630cd57557a2183175b87156e2",
        "0e82ba213a53f64bd85f641da065e2d8"
    ]
}

# 同步岗位角色

# 基本信息

用途说明：统一用户平台向下游应用系统同步岗位角色数据

请求方式：POST

请求流向：统一用户平台->服务总线->下游应用系统

接口地址：各应用系统自己拟定

# 请求方式

请求头：Content-Type=application/json

请求体：

参数字段	必填	字段类型	字段名称	示例
Request	是	Object
Data	是	List
operation	是	String	操作类型（update：新增或修改；delete：删除）
id	是	String	统一用户平台岗位角色id
postCode	是	String	岗位编码
roleCode	是	String	角色编码
orgCode		String	机构编码
activity	是	Boolean	是否启用	true/false
startDate		String	开始日期，格式：yyyy-MM-dd	2022-10-01
endDate		String	结束日期，格式：yyyy-MM-dd	2023-09-30
pyCode		String	拼音码
wbCode		String	五笔码
mark		String	备注
seqNo		Integer	排序值

# 请求结构示例

{
	"Request": {
		"Data": [{
			"operation": "update",
			"id": "b4bfd76565b9dee9c88c51aa57ccb053",
			"postCode": "53453",
			"roleCode": "4342342",
			"orgCode": "DHSZHYYZY",
			"activity": true,
			"startDate": "2022-09-05",
			"endDate": null,
			"pyCode": null,
			"wbCode": null,
            "seqNo": null,
			"mark": "a"
		}]
	}
}

# 返回参数

参数字段	必填	字段类型	字段名称	示例
code	是	String	响应状态	200-成功 201-部分失败其他-全部失败
msg	否	String	错误信息
data	是	List	同步成功的统一用户平台岗位角色id集合

# 返回结构示例

{
    "code":"200",
    "msg":"success",
    "data":[
        "940f36630cd57557a2183175b87156e2",
        "0e82ba213a53f64bd85f641da065e2d8"
    ]
}

# 查询菜单和权限（异构）

# 基本信息

用途说明：统一用户平台向下游应用系统查询应用系统自身的菜单和权限数据

请求方式：POST

请求流向：统一用户平台->服务总线->下游应用系统

接口地址：各应用系统自己拟定

# 请求方式

请求头：Content-Type=application/json

请求体：

参数字段	必填	字段类型	字段名称
Request	是	Object
Data	是	List
roleCode	是	String	角色编码
orgCode	否	String	机构编码

# 请求结构示例

{
	"Request": {
		"Data": [{
			"roleCode ": "code1",
			"orgCode": " orgCode1"
		}]
	}
}

# 返回参数

参数字段	必填	字段类型	字段名称	示例
code	是	String	响应状态
msg	否	String	错误信息
data	是	List《Object》	资源和权限列表
tabId	是	String	页签id（对应一个类型的权限）
tabName	否	String	页签名称	例如：headMenu
tabDesc	是	String	页签描述（页面上显示的页签名称）	例如：菜单
perms	是	List《Object》	权限列表
--permId	是	String	权限id
--parentPermId	否	String	权限父id
--permName	否	String	权限名
--permDesc	是	String	权限描述（页面上显示的权限名称）	例如：领药审核
--checked	是	Boolean	是否已授权
--children	否	List《Object》	子级权限

# 返回结构示例

{
    "success":true,
    "code":"200",
    "msg":"success",
    "data":[
        {
            "roleCode":"code1",
            "orgCode":"orgCode1",
            "tabId":"01",
            "tabName":"INPDOCHEAD",
            "tabDesc":"住院医师头菜单",
            "perms":[
                {
                    "permId":"57579",
                    "permDesc":"治疗站",
                    "permName":"doccure.workreport.hui.in",
                    "parentPermId":"50209",
                    "checked":true,
                    "children":[
                        {
                            "permId":"57580",
                            "permDesc":"治疗站个人工作量统计",
                            "permName":"doccure.workreport.user.hui.in",
                            "checked":true,
                            "parentPermId":"57579"
                        },
                        {
                            "permId":"57581",
                            "permDesc":"治疗站科室工作量统计",
                            "permName":"doccure.workreport.dept.hui.in",
                            "checked":true,
                            "parentPermId":"57579"
                        }
                    ]
                },
                {
                    "permId":"58072",
                    "permDesc":"领药审核-停用",
                    "permName":"drugauditnews",
                    "parentPermId":"50209",
                    "checked":true
                }
            ]
        },
        {
            "roleCode":"code2",
            "orgCode":"orgCode2",
            "tabId":"02",
            "tabName":"TAB2",
            "tabDesc":"住院医师侧菜单",
            "perms":[
                {
                    "permId":"58072",
                    "permDesc":"领药审核-停用",
                    "permName":"drugauditnews",
                    "parentPermId":"50209",
                    "checked":true
                }
            ]
        }
    ]
}

# 同步权限（异构）

# 基本信息

用途说明：统一用户平台向下游应用系统同步权限数据

请求方式：POST

请求流向：统一用户平台->服务总线->下游应用系统

接口地址：各应用系统自己拟定

# 请求方式

请求头：Content-Type=application/json

请求体：

参数字段	必填	字段类型	字段名称	示例
Request	是	Object
Data	是	List《Object》
roleCode	是	String	角色编码
orgCode	否	String	机构编码
perms	是	List《String》	权限id集合	格式：permId

# 请求结构示例

{
	"Request": {
		"Data": [{
			"roleCode": "code1",
			"orgCode": "orgCode2",
			"perms": [
				"1073|0",
				"1074|1"
			]
		}]
	}
}

# 返回参数

参数字段	必填	字段类型	字段名称
code	是	String	响应状态
msg	否	String	错误信息
data	是	List

# 返回结构示例

{
    "code":"200",
    "msg":"",
    "data":[]
}

← 文档说明应用请求统一用户接口 →