本文整合了原 AuthAPI.md 与 AuthUserAPI.md 的内容，以本文件为准。

目录

• 目录
• 摘要
• 入口函数
  • Fx.auth.getUser
  • Fx.auth.getRole
  • Fx.auth.getOuterUser
• AuthUserAPI
  • getRolesByUsers
  • getUsersByRoleCodes
  • batchAddUserRole
  • batchSetUserRoles
  • deleteByUserIds
  • queryUsedCRM
  • getUsersByRoleCodesWithAppId
• AuthRoleAPI
  • getRoleList
  • createAdminRole
  • createRole
  • deleteRole
  • updateRole
  • replicateRole
  • deleteAdminRole
  • updateAdminRole
  • replicateAdminRole
  • addRoleWithDepartmentToEmployeesByAppId
• AuthOuterUserAPI
  • deleteByUserIds
  • updateRoles
• 版本记录
• 背景说明
• 适用场景
• 前置条件
• 操作步骤
• 注意事项

摘要

本文档的概要说明如下： 本文整合了原 AuthAPI.md 与 AuthUserAPI.md 的内容，以本文件为准。

入口函数

Fx.auth.getUser

以人员为主语进行查询。

Fx.auth.getUser()

参考函数API：

• com.fxiaoke.functions.api.AuthUserAPI

Fx.auth.getRole

以角色为主语进行查询。

Fx.auth.getRole()

参考函数API：

• com.fxiaoke.functions.api.AuthRoleAPI

Fx.auth.getOuterUser

以外部人员为主语进行查询。

Fx.auth.getOuterUser()

参考函数API：

• com.fxiaoke.functions.api.AuthOuterUserAPI

AuthUserAPI

getRolesByUsers

以人员为主语，查询所有的角色。

AuthUserAPI.getRolesByUsers(<string roleSource>, <array userIds>)

参数说明

入参格式

参数名称	object	描述	是否必填
roleSource	string	角色类型，1 表示内部角色，2 表示外部角色	是
userIds	array[string]	员工 ID	是

出参格式

参数名称	object	描述
appId	string
userId	string
roleCode	string
majorRole	boolean
outerTenantId	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

def(boolean error, List data, String message) = Fx.auth.user.getRolesByUsers(1, ["1001"])
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

getUsersByRoleCodes

以角色为主语，查询所有人员。

AuthUserAPI.getUsersByRoleCodes(<array roleCodes>)

参数说明

入参格式

参数名称	object	描述	是否必填
roleCodes	array[string]	角色编码列表	是

出参格式

参数名称	object	描述
appId	string
userId	string
roleCode	string
majorRole	boolean
outerTenantId	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

List roleCodes = ["00000000000000000000000000000009"]
def(boolean error, List data, String message) = Fx.auth.user.getUsersByRoleCodes(roleCodes)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

负责人：斯作益seth

batchAddUserRole

追加角色。

AuthUserAPI.batchAddUserRole(<array roleCodes>, <boolean updateMajorRole>, <string majorRole>, <array userIds>)

参数说明

入参格式

参数名称	object	描述	是否必填
roleCodes	array[string]	角色编码列表	是
updateMajorRole	boolean	是否更新主角色	是
majorRole	string	主角色编码	是
userIds	array[string]	用户 ID 列表	是

Groovy 举例

def(boolean error, Map data, String message) = Fx.auth.user.batchAddUserRole(
  ["00000000000000000000000000000009"],
  true,
  "00000000000000000000000000000009",
  ["1069"]
)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

负责人：斯作益seth

batchSetUserRoles

设置人员的角色，以提交参数为准。

AuthUserAPI.batchSetUserRoles(<array userIds>, <array roleCodes>, <string majorRole>)

参数说明

入参格式

参数名称	object	描述	是否必填
userIds	array[string]	用户 ID 列表	是
roleCodes	array[string]	角色编码列表	是
majorRole	string	主角色编码	是

Groovy 举例

def(boolean error, Map data, String message) = Fx.auth.user.batchSetUserRoles(
  ["1046"],
  ["00000000000000000000000000000009", "00000000000000000000000000000014"],
  "00000000000000000000000000000014"
)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

负责人：斯作益seth

deleteByUserIds

以角色为主语，删除人员。

AuthUserAPI.deleteByUserIds(<string roleCode>, <array userIds>)

参数说明

入参格式

参数名称	object	描述	是否必填
roleCode	string	角色编码	是
userIds	array[string]	用户 ID 列表	是

出参格式

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

def(boolean error, Map data, String message) = Fx.auth.user.deleteByUserIds(
  "00000000000000000000000000000009",
  ["1267"]
)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

负责人：斯作益seth

queryUsedCRM

查询企业使用 CRM 角色的数量。

AuthUserAPI.queryUsedCRM()

参数说明

出参格式

参数名称	object	描述
usedQuotaSize	integer	已使用额度数量

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

def(boolean error, Map data, String message) = Fx.auth.user.queryUsedCRM()
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

负责人：斯作益seth

getUsersByRoleCodesWithAppId

以角色为主语，查询所有人员。

AuthUserAPI.getUsersByRoleCodesWithAppId(<string appId>, <array roleCodes>)

参数说明

入参格式

参数名称	object	描述	是否必填
appId	string	应用 ID	是
roleCodes	array[string]	角色编码列表	是

出参格式

参数名称	object	描述
appId	string
userId	string
roleCode	string
majorRole	boolean
outerTenantId	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

List roleCodes = ["00000000000000000000000000000009"]
String appId = "facishare-system"
def(boolean error, List data, String message) = Fx.biz.callAPI("getUsersByRoleCodesWithAppId", appId, roleCodes)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

AuthRoleAPI

getRoleList

查询角色列表。

AuthRoleAPI.getRoleList(<array appIds>, <string roleSource>)

参数说明

入参格式

参数名称	object	描述	是否必填
appIds	array[string]	应用 ID 列表	是
roleSource	string	角色来源	是

出参格式

参数名称	object	描述
list	array[object]	角色列表

list	object	描述
groupName	string
roleName	string
roleCode	string
roleType	integer
appId	string
tenantId	string
description	string
delFlag	boolean
roleOrder	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

List appIds = ["facishare-system"]
String roleSource = "1"
def(boolean error, List data, String message) = Fx.auth.role.getRoleList(appIds, roleSource)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

负责人：斯作益seth

createAdminRole

添加管理功能权限角色。

AuthRoleAPI.createAdminRole(<string roleName>, <string description>, <string roleType>, <string sourceRoleCode>, <string appId>, <string licenseCode>)

参数说明

入参格式

参数名称	object	描述	是否必填
roleName	string	角色名称	是
description	string	角色描述	是
roleType	string	角色类型	是
sourceRoleCode	string	来源角色编码	是
appId	string	应用 ID	是
licenseCode	string	许可证编码	是

出参格式

参数名称	object	描述
roleCode	string
errorReason	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

String roleName = "自定义管理功能权限"
String description = "自定义管理功能权限描述"
String roleType = "admin"
String sourceRoleCode = "source-role-code"
String appId = "facishare-system"
String licenseCode = "license-code"
def (boolean error, Map returnObj, String message) = Fx.auth.role.createAdminRole(
  roleName,
  description,
  roleType,
  sourceRoleCode,
  appId,
  licenseCode
)
if (error) {
  log.info("=====" + message)
} else {
  log.info("returnObj:" + returnObj)
}

负责人：斯作益seth

createRole

添加角色。

AuthRoleAPI.createRole(<string appId>, <string roleName>, <array functionCodes>, <string description>)

参数说明

入参格式

参数名称	object	描述	是否必填
appId	string	应用 ID	是
roleName	string	角色名称	是
functionCodes	array[string]	功能编码列表	是
description	string	角色描述	是

出参格式

参数名称	object	描述
roleCode	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

String appId = "facishare-system"
String roleName = "自定义管理功能权限"
List functionCodes = ["function-code-1"]
String description = "自定义管理功能权限描述"
def (boolean error, Map returnObj, String message) = Fx.auth.role.createRole(
  appId,
  roleName,
  functionCodes,
  description
)
if (error) {
  log.info("=====" + message)
} else {
  log.info("returnObj:" + returnObj)
}

负责人：斯作益seth

deleteRole

删除角色。

AuthRoleAPI.deleteRole(<string roleCode>, <boolean isManagement>)

参数说明

入参格式

参数名称	object	描述	是否必填
roleCode	string	角色编码	是
isManagement	boolean	是否为管理角色	是

出参格式

参数名称	object	描述
roleCode	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

String roleCode = "1234"
boolean isManagement = false
def (boolean error, Map returnObj, String message) = Fx.auth.role.deleteRole(roleCode, isManagement)
if (error) {
  log.info("=====" + message)
} else {
  log.info("returnObj:" + returnObj)
}

负责人：斯作益seth

updateRole

更新角色。

AuthRoleAPI.updateRole(<string roleCode>, <string roleName>, <string description>, <string roleGroupCode>)

参数说明

入参格式

参数名称	object	描述	是否必填
roleCode	string	角色编码	是
roleName	string	角色名称	是
description	string	角色描述	是
roleGroupCode	string	角色分组编码	是

出参格式

参数名称	object	描述
roleCode	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

String roleCode = "1234"
String roleName = "自定义管理功能权限"
String description = "自定义管理功能权限描述"
String roleGroupCode = "roleGroupCode1"
def (boolean error, Map returnObj, String message) = Fx.auth.role.updateRole(
  roleCode,
  roleName,
  description,
  roleGroupCode
)
if (error) {
  log.info("=====" + message)
} else {
  log.info("returnObj:" + returnObj)
}

负责人：斯作益seth

replicateRole

复制角色，不能复制 CRM 管理员的角色。

AuthRoleAPI.replicateRole(<string fromRoleCode>, <string roleName>, <string description>, <string roleGroupCode>, <boolean isManagement>)

参数说明

入参格式

参数名称	object	描述	是否必填
fromRoleCode	string	来源角色编码	是
roleName	string	角色名称	是
description	string	角色描述	是
roleGroupCode	string	角色分组编码	是
isManagement	boolean	是否为管理角色	是

Groovy 举例

String fromRoleCode = "1234"
String roleName = "自定义管理功能权限"
String description = "自定义管理功能权限描述"
String roleGroupCode = "roleGroupCode1"
boolean isManagement = false
def (boolean error, Map returnObj, String message) = Fx.auth.role.replicateRole(
  fromRoleCode,
  roleName,
  description,
  roleGroupCode,
  isManagement
)
if (error) {
  log.info("=====" + message)
} else {
  log.info("returnObj:" + returnObj)
}

负责人：斯作益seth

deleteAdminRole

删除管理功能权限角色。

AuthRoleAPI.deleteAdminRole(<string appId>, <string roleCode>)

参数说明

入参格式

参数名称	object	描述	是否必填
appId	string	应用 ID	是
roleCode	string	角色编码	是

出参格式

参数名称	object	描述
error	string
roleCode	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

String appId = "facishare-system"
String roleCode = "1234"
def (boolean error, Map returnObj, String message) = Fx.auth.role.deleteAdminRole(appId, roleCode)
if (error) {
  log.info("=====" + message)
} else {
  log.info("returnObj:" + returnObj)
}

负责人：斯作益seth

updateAdminRole

修改管理功能权限角色。

AuthRoleAPI.updateAdminRole(<string appId>, <string roleCode>, <string roleName>, <string description>)

参数说明

入参格式

参数名称	object	描述	是否必填
appId	string	应用 ID	是
roleCode	string	角色编码	是
roleName	string	角色名称	是
description	string	角色描述	是

出参格式

参数名称	object	描述
roleCode	string
error	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

String appId = "facishare-system"
String roleCode = "1234"
String roleName = "自定义管理功能权限"
String description = "自定义管理功能权限描述"
def (boolean error, Map returnObj, String message) = Fx.auth.role.updateAdminRole(
  appId,
  roleCode,
  roleName,
  description
)
if (error) {
  log.info("=====" + message)
} else {
  log.info("returnObj:" + returnObj)
}

负责人：斯作益seth

replicateAdminRole

复制角色，不能复制 CRM 管理员的角色。

AuthRoleAPI.replicateAdminRole(<string roleName>, <string description>, <integer roleType>, <string sourceRoleCode>, <string appId>, <string licenseCode>)

参数说明

入参格式

参数名称	object	描述	是否必填
roleName	string	角色名称	是
description	string	角色描述	是
roleType	integer	角色类型	是
sourceRoleCode	string	来源角色编码	是
appId	string	应用 ID	是
licenseCode	string	许可证编码	是

出参格式

参数名称	object	描述
roleCode	string
errorReason	string

出参样例

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy 举例

String roleName = "自定义管理功能权限"
String description = "自定义管理功能权限描述"
Integer roleType = 1
String sourceRoleCode = "sourceRoleCode1"
String appId = "facishare-system"
String licenseCode = "license-code"
def (boolean error, Map returnObj, String message) = Fx.auth.role.replicateAdminRole(
  roleName,
  description,
  roleType,
  sourceRoleCode,
  appId,
  licenseCode
)
if (error) {
  log.info("=====" + message)
} else {
  log.info("returnObj:" + returnObj)
}

负责人：斯作益seth

addRoleWithDepartmentToEmployeesByAppId

给人员分配管理角色，可分配 CRM 管理员。

AuthRoleAPI.addRoleWithDepartmentToEmployeesByAppId()

Groovy 举例

List employeeIds = [1000]
def currentEmployeeId = 1000
def roleCodeAndDepartmentIds = [
  "roleCode": "31",
  "departmentIds": [999999]
]
def(boolean error, List data, String message) = Fx.auth.role.addRoleWithDepartmentToEmployeesByAppId(
  currentEmployeeId,
  employeeIds,
  roleCodeAndDepartmentIds
)

负责人：斯作益seth

AuthOuterUserAPI

deleteByUserIds

以角色为主语，删除互联人员。

AuthOuterUserAPI.deleteByUserIds(<array userIds>, <string roleCode>)

参数说明

入参格式

参数名称	object	描述	是否必填
userIds	array[string]	用户 ID 列表	是
roleCode	string	角色编码	是

Groovy 举例

def (boolean error, Map returnObj, String message) = Fx.auth.outerUser.deleteByUserIds(
  ["1000"],
  "00000000000000000000000000000009"
)
if (error) {
  log.info("error: " + message)
} else {
  log.info("returnObj:" + returnObj)
}

负责人：斯作益seth

updateRoles

覆盖更新互联用户的所有角色。

AuthOuterUserAPI.updateRoles(<array userIds>, <string majorRole>, <array roleCodes>)

参数说明

入参格式

参数名称	object	描述	是否必填
userIds	array[string]	用户 ID 列表	是
majorRole	string	主角色编码	是
roleCodes	array[string]	角色编码列表	是

Groovy 举例

def (boolean error, Map returnObj, String message) = Fx.auth.outerUser.updateRoles(
  ["300383629"],
  "5b6817bbe4b066655a6397e4",
  ["5b6817bbe4b066655a6397e4"]
)
if (error) {
  log.info("error: " + message)
} else {
  log.info("returnObj:" + returnObj)
}

版本记录

版本	日期	变更内容	负责人
v1.0	2026-05-19	初始版本

背景说明

本文档详细描述 Fx.auth 的相关接口功能和使用方法，帮助开发者快速集成相关能力。

适用场景

具体适用场景由实际业务需求决定，开发者可根据需要选择相应的接口进行集成。

前置条件

• 已接入纷享销客开放平台
• 已完成应用授权与配置
• 了解相关业务领域基础知识

操作步骤

具体操作步骤请参考各接口的详细说明。

注意事项

• 调用接口前请确保满足前置条件
• 注意接口调用频率限制
• 异常情况请参考错误码说明进行处理

以上代码示例执行后将返回对应接口的调用结果。

兼容性说明：当前版本暂无可用的废弃或兼容性说明。