查询多个证书的信息

查询多个证书的详细信息。

请求 URL

GET {base_url}/{api_path}/certificate/query?access_token={access_token}

请求参数

参数 是否必填 类型 说明
ids 是 String 证书 ID。
注：
  • 可通过 查询证书列表 查询证书 ID。
  • 使用半角逗号 (,) 分隔多个 ID。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
total_number Integer 搜索到的证书总数。
certificate_list Array<Cert_Info> 证书信息。
Cert_Info
参数 类型 说明
id Integer 证书 ID。
name String 证书名称。
type String 证书类型。
  • trusted：受信任证书。
  • server：PBX 服务器证书。
issue_to String 证书所关联的域名。
expiration String 证书的到期时间。
ca_type String 证书的添加方式。
注： 此参数仅在 PBX 服务器证书信息中返回。
  • upload：导入证书到 PBX 中。
  • apply：通过 PBX 申请证书。
auto_renewal Integer 证书是否启用了自动刷新。
注： 此参数仅在 PBX 服务器证书信息中返回。
  • 0：禁用。
  • 1：启用。
dns_provider String

指定用于证书申请和自动刷新的 DNS 服务提供商。

注： 此参数仅在 PBX 服务器证书信息中返回。
apply_status String
证书的当前申请状态。
  • issuing：申请中。
  • issuance_success：签发成功。
  • issuance_fail：签发失败。
apply_tip_code Integer 证书申请或刷新操作的提示码。
注： 此参数在证书申请或刷新失败时返回，且该提示码由 DNS 服务器生成。
auth_info_list Array<Auth_Info> 用于证书申请和自动刷新的 DNS 验证信息。
Auth_Info
注： 有关 DNS 验证参数的详细说明，请参见 支持的 DNS 提供商。
参数 类型 说明
k String DNS 提供商定义的验证参数键名。
iv Integer 用于返回整型格式的验证参数值。
sv String 用于返回字符串格式的验证参数值。
bv Boolean 用于返回布尔型格式的验证参数值。

示例

请求示例

GET /openapi/v1.0/certificate/query?access_token=PySjo9peg6lAfStDbw5uQKEMQ2RXtnno&ids=4,5,6 HTTP/1.1
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "total_number": 3,
    "certificate_list": [
        {
            "id": 4,
            "name": "pbx_internal_ca.crt",
            "type": "trusted",
            "issue_to": "internal.company.local",
            "expiration": "2025/05/25 10:45:42 AM",
            "apply_status": "issuance_success"
        },
        {
            "id": 5,
            "name": "production_server_cert.pem",
            "type": "server",
            "issue_to": "pbx.company.com",
            "expiration": "2025/05/25 10:45:42 AM",
            "ca_type": "upload",
            "auto_renewal": 1,
            "dns_provider": "alidns",
            "apply_status": "issuance_success",
            "auth_info_list": [
                {
                    "k": "TTL",
                    "iv": 600
                },
                {
                    "k": "AccessKeyId",
                    "sv": "AKIAIXXXXXXXXXXAMPLE"
                },
                {
                    "k": "AccessKeySecret",
                    "sv": "wJalrXUXXXXXXXXXXLEKEY"
                },
                {
                    "k": "PropagationTimeout",
                    "iv": 300
                },
                {
                    "k": "PollingInterval",
                    "iv": 5
                }
            ]
        },
        {
            "id": 6,
            "name": "docs_server_cert.pem",
            "type": "server",
            "issue_to": "docs.company.com",
            "expiration": "2026/04/19 08:56:08 AM",
            "ca_type": "apply",
            "auto_renewal": 1,
            "dns_provider": "alidns",
            "apply_status": "issuance_success",
            "auth_info_list": [
                {
                    "k": "PropagationTimeout",
                    "iv": 300
                },
                {
                    "k": "PollingInterval",
                    "iv": 5
                },
                {
                    "k": "TTL",
                    "iv": 600
                },
                {
                    "k": "AccessKeyId",
                    "sv": "AKIAIOSFODNN7EXAMPLE"
                },
                {
                    "k": "AccessKeySecret",
                    "sv": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
                },
            ]
        }
    ]
}