批量操作企业初始化

1. 接口描述

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

支持企业进行批量初始化操作：

此接口存在以下限制：

1. 批量操作的企业需要已经完成电子签的认证流程。
2. 通过此接口生成的链接在小程序端进行操作时，操作人需要是所有企业的超管或法人。
3. 批量操作的企业，需要是本方第三方应用下的企业。
4. 操作链接过期时间默认为生成链接后7天。

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

2. 输入参数

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

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：CreateBatchInitOrganizationUrl。
Version	是	String	公共参数，本接口取值：2021-05-26。
Region	否	String	公共参数，此参数为可选参数。
Agent	是	Agent	应用相关信息。 此接口Agent.AppId 必填。
OperateTypes.N	是	Array of String	初始化操作类型 CREATE_SEAL : 创建印章 OPEN_AUTO_SIGN :开通企业自动签署 PARTNER_AUTO_SIGN_AUTH :合作方企业或应用平台方授权自动签 示例值：[OPEN_AUTO_SIGN, AUTH_JOIN_ORGANIZATION_GROUP, CREATE_SEAL]
ProxyOrganizationOpenIds.N	是	Array of String	批量操作的企业列表在第三方平台的企业Id列表，即ProxyOrganizationOpenId列表,最大支持50个 示例值：[tencent-testorg-cd, tencent-testorg-ca]
IsAuthorizePlatformApplication	否	Boolean	当操作类型包含 PARTNER_AUTO_SIGN_AUTH 且是给应用平台方授权自动签时传true。 示例值：false
AuthorizedProxyOrganizationOpenId	否	String	被授权的合作方企业在第三方平台子客企业标识，即ProxyOrganizationOpenId，当操作类型包含 PARTNER_AUTO_SIGN_AUTH 且要进行合作方企业授权自动签时必传。 示例值：org_dianziqian

3. 输出参数

4. 示例

示例1 创建批量操作企业初始化链接

输入示例

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

{
    "Agent": {
        "ProxyOrganizationOpenId": "",
        "AppId": "yDKHHUUckpacc9ijUuXGmVcuzACNH5pF"
    },
    "ProxyOrganizationOpenIds": [
        "tencent-testorg-cd",
        "tencent-testorg-ca",
        "tencent-testorg-zhangy",
        "tencent-testorg-tianjing",
        "tencent-testorg-hongkong"
    ],
    "OperateTypes": [
        "OPEN_AUTO_SIGN",
        "CREATE_SEAL"
    ]
}

输出示例

{
    "Response": {
        "MiniAppPath": "pages/guide/index?to=BATCH_INITIALIZATION_ORGANIZATIONS&shortKey=yDAHpURDfyLc5LgBhXb6",
        "OperateLongUrl": "https://res.ess.tencent.cn/cdn/h5-activity-dev/jump-mp.html?to=BATCH_INITIALIZATION_ORGANIZATIONS&shortKey=yDCHpURDfyLc5LgBhXb6",
        "OperateShortUrl": "https://essurl.cn/zahbUBHxW3",
        "QRCodeUrl": "https://dyn.ess.tencent.cn/imgs/qrcode_urls/batch_initialization_organizations/yDCHHUUckpacc9ijUuXGmVcuzZCNH5pF.png",
        "RequestId": "s1723520103899037060"
    }
}

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: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

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