接口请求域名： organization.intl.tencentcloudapi.com 。
获取企业组织信息
默认接口请求频率限制：40次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：DescribeOrganization。 |
| Version | 是 | String | 公共参数，本接口取值：2021-03-31。 |
| Region | 否 | String | 公共参数，本接口不需要传递此参数。 |
| Lang | 否 | String | 国际站：en，国内站：zh |
| Product | 否 | String | 可信服务产品简称。查询是否该可信服务管理员时必须指定 |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| OrgId | Integer | 企业组织ID。 |
| HostUin | Integer | 创建者UIN。 |
| NickName | String | 创建者昵称。 |
| OrgType | Integer | 企业组织类型。 |
| IsManager | Boolean | 是否组织管理员。是：true ，否：false |
| OrgPolicyType | String | 策略类型。财务管理：Financial |
| OrgPolicyName | String | 策略名。 |
| OrgPermission | Array of OrgPermission | 成员财务权限列表。 |
| RootNodeId | Integer | 组织根节点ID。 |
| CreateTime | String | 组织创建时间。 |
| JoinTime | String | 成员加入时间。 |
| IsAllowQuit | String | 成员是否允许退出。允许：Allow，不允许：Denied |
| PayUin | String | 代付者Uin。 |
| PayName | String | 代付者名称。 |
| IsAssignManager | Boolean | 是否可信服务管理员。是：true，否：false |
| IsAuthManager | Boolean | 是否实名主体管理员。是：true，否：false |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
POST / HTTP/1.1
Host: organization.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeOrganization
<公共请求参数>
{}
{
"Response": {
"CreateTime": "2021-04-15 21:07:54",
"JoinTime": "2021-04-15 21:07:54",
"HostUin": 1001,
"IsManager": true,
"NickName": "host_name",
"OrgId": 101,
"OrgPermission": [
{
"Id": 1,
"Name": "viewBill"
},
{
"Id": 2,
"Name": "viewBalance"
}
],
"OrgPolicyName": "财务管理",
"OrgPolicyType": "Financial",
"OrgType": 1,
"RootNodeId": 1001,
"IsAllowQuit": "Allow",
"PayUin": "",
"PayName": "",
"IsAssignManager": false,
"IsAuthManager": false,
"RequestId": "e5c09721-236b-4a55-a5d1-0513ac506245"
}
}
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.OperateBillingPermissionErr | 操作计费侧成员权限错误。 |
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| ResourceNotFound.OrganizationNotExist | 企业组织不存在。 |
文档反馈