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 *.example.com test.example.com

Error code

Error code(code)Description(message)HTTP statusSemantic
NoSuchSslThe 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 **
DecryptFailErrorDecoding fails, please check if you certificate is invalid400Decoding fails, please check if you certificate is invalid
PARAM_INVALIDParameter {} is null or invalid400Parameter {} is null or invalid
WRONG_OPERATORSubmission operator does not match the customer.400Submission operator does not match the customer.
successIndicates 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!