查询信息模板--证书中心-火山引擎

文档中心

立即注册

导航

查询信息模板

最近更新时间：2024.07.04 17:27:42首次发布时间：2023.10.19 10:52:38

调用本接口查询已有的信息模板。

注意事项

请求频率：同一个租户每秒最多允许请求20次。

请求说明

接口名称：CertificateGetOrganization
请求方式：GET
请求地址：open.volcengineapi.com

调试

暂不支持。

请求参数

下方表格中的参数包含在请求头（header）中。

参数	类型	是否必选	描述	示例值
Region	string	是	服务地区。该参数的取值是`cn-north-1`。	`cn-north-1`
ServiceName	string	是	服务名称。该参数的取值是`certificate_service`。	`certificate_service`

Query

下方表格中的参数包含在查询字符串（query string）中。

参数	类型	是否必选	描述	示例值
Action	string	是	API名称。该参数的取值是`CertificateGetOrganization`。	`CertificateGetOrganization`
Version	string	是	API版本。该参数的取值是`2021-06-01`。	`2021-06-01`
organization_id	String	否	设置一个模板ID以按ID查询信息模板。	`org-4d954cd1fe8e487086e67f687f83****`
ov	String	否	设置一个模板类型以按类型查询信息模板。该参数有以下取值：为空：查询全部模板。 `0`：仅查询个人类型的模板。 `1`：仅查询企业类型的模板。	`0`
tag	String	否	设置一个模板名称以按名称查询信息模板。支持模糊匹配。	`doc-test`
project_name	String	否	设置一个火山引擎项目名称，以按信息模板所属的项目查询信息模板。	`default`

返回参数

参数	类型	描述	示例值
count	Integer	满足查询条件的信息模板的总数。
content	Array	信息模板详情列表。

请求示例

GET https://open.volcengineapi.com/?Action=CertificateGetDcvParam&Version=2021-06-01&<其他公共请求参数>

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20231012143611D18B45161E262C169AB5",
        "Action": "CertificateGetOrganizationList",
        "Version": "2021-06-01",
        "Service": "certificate_service",
        "Region": "cn-north-1"
    },
    "Result": {
        "count": 1,
        "content": [
            {
                "id": "org-4d954cd1fe8e487086e67f687f83****",
                "upstream": "volcano",
                "upstream_filter": "21000000XX",
                "ov": 1,
                "tag": "doc-test",
                "project": "default",
                "department": "IT",
                "name": "火山引擎",
                "postal_code": "200000",
                "address": "某某路某号",
                "city": "上海",
                "province": "上海",
                "country": "中国",
                "email": "zhangsan@volcengine.com",
                "phone": "13111111111",
                "bank_account_license_no": "",
                "business_license_no": "91XXXXXXXXXXXXXXXE",
                "contact": {
                    "first_name": "三",
                    "last_name": "张",
                    "email": "zhangsan@volcengine.com",
                    "phone": "13111111111",
                    "title": "IT负责人",
                    "id_card_no": "111111111111111111"
                }
            }
        ]
    }
}

错误码

如果响应正文的ResponseMetadata字段中包含Error字段，则表示API请求失败。您可访问公共错误码，获取更多错误码信息。

证书中心