List Certificates

This API is used to list certificates of customer.

1. Request Definition

• API URL

https://base-api.swiftfederation.com/v1.0/certs/customer/${customerId}

• Request Protocol

GET

• Request Header

Request Header

• Request Body

No request body for this API.

• Request Example

GET /v1.0/certs/customer/123 HTTP/1.1
Host: base-api.swiftfederation.com

Authorization:HMAC-SHA256 V265i4K31j991E19:bc051d2e520a462e36455dc75b2bc68e9a135bbf4d2fefbf6d2fc1f28c5aa5dc
Content-Type:application/json; charset=utf-8
X-SFD-Date:20240918T081000Z
X-SFD-Nonce:69527

2. Response Definition

This section is intended to describe response header and body data definition.

2.1. Success Response

• Success Response Body

Field	Data Type	Description
id	long	certificate id
customerId	Integer	the certificate under customer id.
commonName	String	common name.
subjectAlternativeNames	String	subject alternative names
serialNumber	String	serial number.
issuer	String	issuer.
organization	String	organization
organizationalUnit	String	organizational unit
country	String	country
stateOrProvince	String	state or province.
locality	String	locality
validFrom	String	valid from.
validTo	String	valid to.
created	String	created
expireIn	int	expireIn

• Success Response Body Example

{
    "certs": [
        {
            "id": 2362,
            "customerId": 123,
            "commonName": "test15.com",
            "subjectAlternativeNames": "DNS:test15.com",
            "serialNumber": "223671316347523214428015009789628456690",
            "issuer": "MySSL.com",
            "organization": "",
            "organizationalUnit": "",
            "country": "CN",
            "stateOrProvince": "",
            "locality": "",
            "validFrom": "2024-06-26T08:49:42Z",
            "validTo": "2024-07-26T08:49:42Z",
            "created": "2024-06-26T09:05:20.452Z",
            "expireIn": 21
        },
        {
            "id": 2364,
            "customerId": 123,
            "commonName": "test17.com",
            "subjectAlternativeNames": "DNS:test17.com",
            "serialNumber": "4441663121581897505720151647690137728",
            "issuer": "MySSL.com",
            "organization": "",
            "organizationalUnit": "",
            "country": "CN",
            "stateOrProvince": "",
            "locality": "",
            "validFrom": "2024-06-26T12:50:41Z",
            "validTo": "2024-06-31T12:50:41Z",
            "created": "2024-06-26T12:51:40.573Z",
            "expireIn": -2
        }
    ]
}

2.2. Error Response

• Error Response Code

Error Code

• Error Response Example

HTTP/1.1 403
{
"code":"Permission.Forbidden",
"message":"Can't access according to this access key id.",
"requestId": "16db8f36813--A-F8-1"
}