跳到主要内容

批量创建变更超管任务

1. 接口描述​

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

本接口（CreateBatchAdminChangeInvitations）用于批量创建企业超管信息变更。 该接口为提交任务接口,如果需要获得链接， 需要使用接口创建超管变更链接(CreateBatchAdminChangeInvitationsUrl)。

批量创建链接有以下限制：

单次最多创建10个企业的超管变更。 同一批创建的企业不能重复,唯一值为企业 Id或者企业 OrganizationOpenId。

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

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数​

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

参数名称必选类型描述
Action是String公共参数，本接口取值：CreateBatchAdminChangeInvitations。
Version是String公共参数，本接口取值：2021-05-26。
Region否String公共参数，此参数为可选参数。
Agent是Agent

关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。

此接口下面信息必填。

  • 渠道应用标识: Agent.AppId
AdminChangeInvitationInfos.N是Array of AdminChangeInvitationInfo

组织机构超管变更信息。 一次最多支持10条超管变更信息。

3. 输出参数​

参数名称类型描述
ErrorMessagesArray of String

批量生成企业认证链接的详细错误信息，顺序与输入参数子企业列表顺序一致。

  • 如果所有企业认证链接都成功生成，将不返回错误信息
  • 如果存在任何错误，将返回具体的错误描述。（没有错误的企业返回空字符串）

示例值：["第【1】条超管变更信息参数错误，当前企业还未认证成功，企业Id是[]"]
RequestIdString唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例​

示例1 给未实名的企业创建变更超管任务失败​

输入示例​

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

{
    "Agent": {
        "AppId": "yDwFoUUckpsomwx1UyhWGhIR2RkhOjw2",
        "ProxyOrganizationOpenId": "ess_open********ation_1",
        "ProxyOperator": {
            "OpenId": "kevi****eng"
        }
    },
    "AdminChangeInvitationInfos": [
        {
            "ChangeAdminOrganizationId": "yDwFmUUckpstjt1aUyN9xSlvgkLEa4NC",
            "ChangeAdminOrganizationOpenId": "ess_open********ation_1",
            "NewAdminOpenId": "Hide*************",
            "NewAdminName": "出木杉",
            "NewAdminMobile": "1320****013",
            "NewAdminIdCardType": "ID_CARD",
            "NewAdminIdCardNumber": "530*************10",
            "AuthFiles": [
                "iVBORw0KGgoAAAANSUhEUgAAALQAAAC0CAMAAAAKE/YAAAABIFBMVEX///8AoOnvfBvgACp/f3+/v78/Pz8vLy/v7+9fX1/f39+fn5/Pz88AltoAUHSPj4+vr69PT0//5DsAHitvb28AeK4AZJEAgr0AKDoAPFcAjMsfHx8AMkgAbqAAWoMARmWoAB9UAA+MABo4AApwABWzXRTEACS2ACJGAA3SACd3Pg0AFB0AAAAqAAcQGR4QJC0fKS5iABJ+ABeaABw/OQ4PDw8sFwVfVRYtHyIdDxKGRQ8rDxXCZBXPuS/gdBmvnChZLgrRbBePgCEfHAfnP187HwYtHxNvYxm/qywcAAVoNgtPRxKfjiTlL1GVTRBKJgjv1Tf5z9cuJyF/ch0vKgs/PjMwOj7zn6/1r7wdDwM8JxU6FwcPDgPfxzNtXUtVSTvP/AqCAAAOFUlEQVR4nO1cd3/ayBaFMFUSKpEEAtHdsGkuwSV907PZ3t7b1/b7f4s3M+oNJ/sQ9r6fzh+JDVgcLmfu3Daq1SpUqFChQoUKFSpUqFChQoUKFSr8vwLKAKAABgBQuWtGmwE149QZqrbdrPvo2n2142BLlu6aWy6IbKw6rW49F/agh617Z3HZMAftiGRfdRxHbSeI9zuuRu6aZwQJLIdxE9szCklN0qljJ2g3Wyt6T2Qi0ZnTwwg7gWGHKGCm4FZaJ859oE3orLMCnEjAcEhjz2ZY1+0VuDOyPsCq1cKcMoEKwdzWfRR/3nssCfUU3hFbAQWrzRblq0txgWEoJtPtKrnY+GNpdJ07NDYw2/UW5j8RzPwZALRVH6T50IxAuLHxHfkRgobMaKfi3WVBFStOfZVmIzk5pOv28k68trLsszd3PHkawiVYENs080Kcu+G074K1bIpV53NkGtFpTQfAlDOv1PL0wcTv7Jy1bIrwYuY7XeYxdKMGAZxnvTAc5pLePWu5JziHYhCrsaZpZJ7z4lxRcyeyW4XIHe9tO4HDRWL5GUrNzXl1jtPzdf3bDn2Ir416fRk+YrF/IBI6qRENJJSNikjXW8bOOMOAczd6T2pB2VWETgjWIIj7YeT0VLWf3Rn5V5Vdt+VAWgY+zI5tJCxd4TyZpqnG/tdiT+GaBCEwTnutZpp0c7Wj8AmH8aad3Y3nxF+UMVMHwYgCTjtpn23vRiBArReThnPoc7T04DEl4iWtUZp2bxfBUywAaqoZ0jICjLTExK2Hz8ma/wOxMKxBV02Q7qL0NUpAFGqqS8NKP0t1l8nDYERgSNrwZQtcb9UBM7EmO+WbWg62NxbLB/KNAdcoRBIhQQjFIHkv0jEIVK6ctnZqarJs9YUyOiKlMmJrH9LrvY9rWcKy0HCYclEubgXFs6xkPtMre18Eartjqs226elUjmI6a2/UaDQO97FFqaEooXJkxLNIlNIAHUSk+xmRbRnLJs+pZ+tgT0DBD3Tc8DC6NiyZ0sB3QEQIwNktJJ4aLDPPbhWyWPktrCPfdMTnA6eC8bffNhrn1ArtyvgSGeflVgT3d7UURTzf5/uGQj26xEIy+9U45Jz/Vqv9vdFYEGhgS4ZQo2xDRzQnKJJkhYT7asn6UHrsLdpegsWE6rkwCSAXLYSd+a9vGvs6z801AGSFiTmzyiSZYkMjNRhFrBkntE1YTIjNKAgOaDPscdJvPNKjQA5MHHryAopmMMJKdDUPTpmkMVuGTpwHow0j0o0fa7UfG42JTxomxZwgzEGWQfw0LFHUPK8epPTHBMAd8I3nOt*********************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************0Fl8+MZJfV7oYRksoV8NlUpMsFtkbTfYuTw6ESp4ePP76cm6wANRAT/b2L8JCzWTPCERA46zVjGVxCbomRi8ly25nMTm82N/jGO8LTEajeEHs6OzGiu14RqQQOzvtIZUyAAJxfJCxzQKerjobT8L+eON4sj/dD34/vhhHFQf/c5+GIWNe9Y6WMzero14okqZQeRsDtDibiOrX+e/vPzz78Or1/mi0P14gkP26Qy+Um6pIZbW7FLoa+iFPiwetYmgUahYT8uLqh4cCP88T/fM4/MJj8zT32RJPlOjUP8zHTN2MdKhdPXv16dEvjx49+uVfRtEW5x9vUPOFoJU6V60AY+WoPTU2aELWr6++eeaZ+uGHTMgU/KGnj8yxGA+w7AFDPhp22lXDlfbrzz88fPbq/SOBq1+K/krUSwvLjbuY9ZU7arDY4PtnV8zUH3xLF767OClQWJopdeotgNsJ3p6sP714+MOrT+//LVhnSUMLc/sK0mbR9XZh6Zo+CzVNmZ6vfv3PH4+ypNmujnhzlj8oSBd/DyVyjb1LWA7WvuGk//jpPef8IhCtxKIQjLzenRJYurjauBvScM1HHvkZcek1I/vN6xfC0Fcyr9whjAygh1ufaOLg+qaBvN2QrrEAjszFVNP6FWP7WnB+4SJeuUv5NeG8edNTLYyMdrIQedmaydnLnDBj/Yl76he/5rlhiZ+V0nlmWzyvuSNL8yhH8o5uEfroxYurh8+uUO7WIcIhykOAwslYpYREIBfEJTXgryzF4sNW+XZU+FcvzeqbSOe0LksCH1ZAtwYN4jhuzehvJF3wecsA1ZLdmTx4L9C92YNC0jtahx4hhZ+R2/wSzlnx6ydFC1HZ3ZE/9mZrxpoaxcGw4nP2A/Eil2ft6sSfAJgzO+tugbEJEJ0xPeBcbxXk3TtUB6fl8qNGBASd5MRzwOUciRXVSwsiU7n0aDr1fqo9o4y2jJEW/+4l2fDu7iEv41Mp+cmWu6OTlSFWvJjKPZYke0PWogDiH2GQwFJNlHo6edmYVs5s4QYgTsrunFJvFksMxnqGgwD30ufe8wZppC235T4DQY/DVp1TZAGNk+a3C8LOsB8a2bZVgYG9zBJE2x+GvA1KvOJl2y2PW3S7oHq/Y84tMUjNPw3OmJrueBUKxHpgOWibTO8WIDoA3rhq2q5l1Exvh5E7xeHDP0S1fnI2Gk32eD+LuPG1SO6Gc9BDz0dP2JWOvZ7A6Ebhm2S0FcHNMUB5IIW3PmAaF/d30MJxziO+9RH/0AaRUTmtxM8Bzpmm8tERRfXo9JE/MCtpzKOz3egOb3ZUcBMSvgoRD+7hWVS2PtxlOLcJtOh+Hk1T4XOJID42u6tc8BZIrpXugAWcZXFuH4zuH2lNrtF0B0xogw9G8PK6vh9xPr4npHk9XF6ldd1UvdSQe+aPEenJHbm4FCSxtAidDWLW7qpLL3IT0b0VjoynZ3zvCkHyTzRkDlnQYduDoRlMUOpivyPYb4UeL3YfG+XCip+ak3k0LUeP+JUBgqYX/BYEN/eE88Z6lhTeOwhaCBlfeHixROTd0ygA2GmS/QXYYGlp0we6U2wgZuyu1vWFKLZ0+lzSPQIt6nYqu89XPxtFhRavWHpfkd/WvrWaerfIle4955ybT0v3nTPbydOpnuzeW2cXIXajqBqfIcy7bc39A9FwUMtjP/0FzOxD4QfiMaL3JyqqUKFChQoVKlSoUKFChQoVKlT4a+C/6zkA3DJsaswAAAAASUVORK5CYII="
            ]
        }
    ]
}

输出示例​

{
    "Response": {
        "ErrorMessages": [],
        "RequestId": "4b5103a0-0340-4dcc-a142-d71d981b9c1a"
    }
}

5. 错误码​

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

错误码描述
FailedOperation操作失败。
FailedOperation.NoRoleAuth无角色授权，请确认数据是否存在
InternalError.DbRead数据库读取失败。
InvalidParameter.ParamError参数错误。
OperationDenied操作被拒绝。
ResourceNotFound.Application应用号不存在。
ResourceNotFound.Flow未找到对应流程。
UnauthorizedOperation.NoPermissionFeature请升级到对应版本后即可使用该接口。
更多开发者交流反馈