EdgeNext Documentation

Endpoint

Request URL: domain/certificate (GET)

API Host: cdn.api.edgenext.com

API Version: v2

Description

Queries the certificate list or certificate details.

Note: Currently only single-ID queries are supported.

Request Parameters

The following list only includes API-specific request parameters. Common request parameters must also be included for production calls — see the Common Request Parameters page.

GET Parameters

Parameters are appended to the URL query string, e.g. ?key1=value1&key2=value2.

Parameter	Data Type	Required	Description
page_number	int	No	Page number. Default: 1
page_size	int	No	Entries per page. Valid range: 1–500. Default: 100
cert_id	int	No	When a certificate ID is provided, list-related parameters are ignored and only that certificate's details are returned

Examples

# Query certificate list
curl -X GET "https://cdn.api.edgenext.com/v2/domain/certificate?token={token}&page_size=15&page_number=1"

# Query single certificate details
curl -X GET "https://cdn.api.edgenext.com/v2/domain/certificate?token={token}&cert_id=123"

Response Example

JSON format:

{
    "code": 0,
    "data": {
        "list": [
            {
                "cert_id": "123", // Certificate ID
                "name": "certName", // Certificate name
                "associated_domains": [ // Associated domains
                    "www.example1.com"
                ],
                "include_domains": [ // Domains covered by the certificate (SAN)
                    "*.example.com"
                ],
                "cert_start_time": "2016-09-30 08:32:26",
                "cert_expire_time": "2019-02-28 08:32:26"
            },
            {
                "cert_id": "124",
                "name": "certName2"
                "associated_domains": [],
                "include_domains": [
                    "www.example2.com"
                ],
                "cert_start_time": "2016-09-30 08:32:26",
                "cert_expire_time": "2019-02-28 08:32:26"
            }
        ],
        "page_size": 100,
        "page_number": 1,
        "total_count": 2
    }
}

Response Headers

HTTP/1.0 200 OK
Api-Id:                782722273
Content-Type:          application/json; charset=utf-8
X-Ratelimit-Grad:      minute
X-Ratelimit-Limit:     100
X-Ratelimit-Remaining: 98
X-Retry-After:         16

HTTP Status Codes

Error Code	Description
404	Bad request URLs.
401	Authorization Error: Invalid token or lack of access.
400	Bad request parameters.
200	Success.
5xx	Please contact your account team.