Certificate MGMT

QueryCertificate

Update time: 2025-07-18 09:47:27

Check the details of SSL certificate, including certificate name, whether it shares or uses the current domain name information, etc.

  • Limit of request rate per user: 10/5min
  • Applicable Products: Certificate MGMT
For API authentication details, please refer to: API Authentication Overview

Request

Path Params

NameDescription
*certificate-idInteger

Certificate IDNote: 1. Refer to the url in the request example, 100166 for certificate-id2.After the new certificate is successfully submitted, the certificate-id corresponding to the certificate can be queried in the location access url in the return parameter. You can also query certificate-id through the QueryCertificateList interface

Response

Body Params

NameDescription
related-domainsLong

List of domain names using the current certificate

certificate-update-timeString

The time of the latest update certificate (CST time zone), for example: 2018-08-01 19:00:01

domain-idInteger

Accelerated domain name ID

domain-nameString

Name of accelerated domain name

share-sslString

Shared, true means shared certificate, false means non-shared certificate

ca-md5String

Certificate ca file content md5

crt-md5String

Certificate crt file content md5

key-md5String

Certificate key file content md5

certificate-serialString

The CRT certificate serial number

certificate-issuerString

The CRT certificate issuer

nameString

Certificate name, unique to customer granularity

commentString

Remarks on certificate file

certificate-validity-toString

The expiration time of the certificate validity period (CST time zone), for example: 2018-08-01 19:00:00

certificate-validity-fromString

The start time of the certificate validity period (CST time zone), for example: 2016-08-01 07:00:00

dns-namesLong

dns-names

dns-nameString

dns-name list, such as <dns-names> <dns-name>*.example.com</dns-name> <dns-name>test.example.com</dns-name> </dns-names>

Error code

Error code(code)Description(message)HTTP statusSemantic
NoSuchSsl

The certificate Id you provided is invalid and the certificate id should be **

404The certificate Id you provided is invalid and the certificate id should be **
DecryptFailError

Decoding fails, please check if you certificate is invalid

400Decoding fails, please check if you certificate is invalid
PARAM_INVALID

Parameter {} is null or invalid

400Parameter {} is null or invalid
WRONG_OPERATOR

Submission operator does not match the customer.

400Submission operator does not match the customer.
success

Indicates that the new domain API was successfully invoked.

202Indicates that the new domain API was successfully invoked.

Example

XML
XML
Request example
Copy Copy success
#!/bin/bash
username="example_username"
apiKey="example_apiKey"
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/api/ssl/certificate/100166" \
-X "GET" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml"
Response example
Copy Copy success
HTTP/1.1 202 OK
Date: Fri, 17 May 2017 06:33:26 GMT
Content-Type: application/xml;charset=utf-8
x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd
<?xml version="1.0" encoding="UTF-8"?>
<ssl-certificate>
  <name>testforsni</name>
  <comment>test for qbox </comment>
  <share-ssl>false</share-ssl>
  <certificate-issuer>CN = 16Root-CA, DC = wangsu, DC = com</certificate-issuer>
  <certificate-serial>23dw4asq2wr544fw24</certificate-serial>
  <related-domains>
    <related-domain>
      <domain-id>123344</domain-id>
      <domain-name>a1.example.com</domain-name>
    </related-domain>
    <related-domain>
      <domain-id>124466</domain-id>
      <domain-name>b1.example.com</domain-name>
    </related-domain>
  </related-domains>
</ssl-certificate>
Is the content of this document helpful to you?
Yes
I have suggestion
Submitted successfully! Thank you very much for your feedback, we will continue to strive to do better!