Skip to main content

Get Attached Certificate Of Domain

The API is used to retrieve the certificate attached to a domain.

Request​

Request-Line​

GET /cdn/v1.0/services/{serviceId}/certificates?domainName={domainName} HTTP/1.1

Request Parameters​

Path Parameters​

ParameterTypeRequiredDescription
serviceIdIntegerMandatoryThe unique identifier of the service.

Query Parameters​

ParameterTypeRequiredDescription
domainNameStringMandatoryThe domain name associated with the specified service ID.

Response​

Response Body​

ParameterTypeDescription
certificateIdIntegerThe unique identifier of the certificate.
domainNameStringCertificate Name. Only present after a successful Attach Certificate to Domain operation.
certTypeStringThe certificate type. Possible values: manual, auto, or none.
autocertRequestStatusStringAuto certificate request status. Possible values: issued, issuing, or failed. Only present after requesting an auto certificate.
autocertRequestTimeIntegerThe request time of auto certificate in Unix epoch milliseconds. Only present after requesting an auto certificate.
validFromStringCertificate start time in Unix epoch milliseconds. Only present after a certificate is attached.
validToStringCertificate expiry time in Unix epoch milliseconds. Only present after a certificate is attached.

Status Codes, Error Codes and Error Messages​

Status CodeError CodeError Message
400ServiceId.InvalidService ID is empty or invalid.
400DomainName.InvalidDomain name is empty or invalid.
400InvalidService.IdPermissionService ID cannot be found or unknown.
400InvalidCertificate.DomainNameEmptyDomain name cannot be empty.
404InvalidService.DomainNameNotFoundDomain name cannot be found.

Examples​

Get Attached Certificate Of Domain​

Request​

GET /cdn/v1.0/services/228771/certificates?domainName=2.FlashCone.com HTTP/1.1

Successful Response Body​

{
"certificateId": 2978,
"domainName": "*.FlashCone.com",
"certType": "manual",
"validFrom": 1747618629000,
"validTo": 1776918778000
}