创建单点登录企业员工信息

1. 接口描述

接口请求域名： ess.tencentcloudapi.com 。

此接口（CreateSingleSignOnEmployees）用于创建单点登录企业员工。
创建好的员工，可以通过腾讯电子签提供的链接， 如下图位置，进行登录。
此操作的功能：

1. 可以绑定已经实名的员工，然后 sso 登录实名绑定。
2. 可以提前导入员工，在 sso 登录的时候进行实名。
3. 如果已经绑定过，可以直接通过 sso 链接登录腾讯电子签。

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：CreateSingleSignOnEmployees。
Version	是	String	公共参数，本接口取值：2020-11-11。
Region	否	String	公共参数，此参数为可选参数。
Operator	是	UserInfo	执行本接口操作的员工信息。使用此接口时，必须填写userId。 注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
Employees.N	是	Array of SingleSignOnEmployees	待创建员工的信息最多不超过200个。 注意： 1. 传递的 openId 不能重复， 且字符不能超过64位。 2. 传递的手机号不能重复。 3. 绑定的角色必须存在且不能超过 10 个。
SsoApplicationId	是	String	单点登录应用号的id,获取位置如下图 示例值：yDtrTUUckp94bix0UEbASLp1TuHxTYTS
Agent	否	Agent	代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。

3. 输出参数

4. 示例

示例1 创建一个单点登录的员工成功示例

创建单点登录员工账号成功
应用号：yDtrTUUckp94bix0UEbASLp1TuHxTYTS
OpenId：OpenId [rUHYMgaz8aNm2IP3Pn8m5q6I3yJDojClFl555uLyeM0]
姓名：电子签
手机号：18888888888
角色：合同管理员和印章管理员的 roleId

输入示例

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSingleSignOnEmployees
<公共请求参数>

{
    "Operator": {
        "UserId": "yDwf3UUckps8dvypUEfH3DjwIpMfa0uw",
        "ClientIp": "8.8.8.8"
    },
    "SsoApplicationId": "yDtrTUUckp94bix0UEbASLp1TuHxTYTS",
    "Employees": [
        {
            "OpenId": "rUHYMgaz8aNm2IP3Pn8m5q6I3yJDojClFl555uLyeM0",
            "Name": "典子谦",
            "Mobile": "18888888888",
            "RoleIds": [
                "32bd40938602d1ee5f7735ee84af5785",
                "yDCHgUUckpbubr9cUxrnpngClLR5YIkR"
            ]
        }
    ]
}

输出示例

{
    "Response": {
        "ErrorMessages": [
            ""
        ],
        "RequestId": "s1758723146173417020",
        "Status": 0
    }
}

示例2 创建一个单点登录的员工失败示例

创建单点登录员工账号失败
应用号：yDtrTUUckp94bix0UEbASLp1TuHxTYTS
原因：OpenId [rUHYMgaz8aNm2IP3Pn8m5q6I3yJDojClFl555uLyeM0] 已存在于系统中
建议：请检查当前员工是否已经导入，如果确定没有被导入使用其他OpenId。

输入示例

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSingleSignOnEmployees
<公共请求参数>

{
    "Operator": {
        "UserId": "yDwf3UUckps8dvypUEfH3DjwIpMfa0uw",
        "ClientIp": "8.8.8.8"
    },
    "SsoApplicationId": "yDtrTUUckp94bix0UEbASLp1TuHxTYTS",
    "Employees": [
        {
            "OpenId": "rUHYMgaz8aNm2IP3Pn8m5q6I3yJDojClFl555uLyeM0",
            "Name": "典子谦",
            "Mobile": "18888888888",
            "RoleIds": [
                "32bd40938602d1ee5f7735ee84af5785",
                "yDCHgUUckpbubr9cUxrnpngClLR5YIkR"
            ]
        }
    ]
}

输出示例

{
    "Response": {
        "ErrorMessages": [
            "导入员工失败，错误信息:[当前openId[rUHYMgaz8aNm2IP3Pn8m5q6I3yJDojClFl555uLyeM0]已经被绑定了，请更换openId进行绑定]"
        ],
        "RequestId": "s1758723146173417020",
        "Status": 2
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。