查询单个证书的信息

查询单个指定证书的详细信息。

请求 URL

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

请求参数

参数 是否必填 类型 说明
id 是 String 证书 ID。
注： 可通过 查询证书列表 查询证书 ID。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
certificate Object<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/get?access_token=mqVLmho7rAPjcXnKSFlv1k3IUhkgKwHH&id=4 HTTP/1.1
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "certificate":{
            "id": 3,
            "name": "docs.example.com.pem",
            "type": "server",
            "issue_to": "docs.example.com",
            "expiration": "-",
            "ca_type": "apply",
            "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
                }
            ]
        }
    ]
}