EdgeNext Documentation

Query HTTP Status Code Statistics

API Endpoint

Request URL: stat/httpcode (GET)

API Request Domain: cdn.api.edgenext.com
API Version: v2

API Description

This API is used to query HTTP status code statistics for accelerated domains.

The default data aggregation interval is 5 minutes. The API request rate limit can be found in the response headers (Response Header).

A single request is limited by the following data point calculation:

Number of domains × Number of data points per day × Number of days ≤ 2880

If the calculated value exceeds this limit, the API returns an error indicating that the request exceeds the maximum allowed limit.

Example:

Querying 2 domains for 2 days with a 5-minute aggregation interval:

2 × 288 × 2 = 1152 < 2880

Request Parameters

Common Parameters

The user's authentication token is required. Please contact the on-call support team to obtain a valid token.

GET Request Parameters

Request parameters should be added to the query string of the URL.

Example:

?key1=value1&key2=value2

Parameter Name	Data Type	Required	Description
domains	string	Yes	Specifies the accelerated domains to query. A maximum of 10 accelerated domains can be queried in a single request. When multiple accelerated domains are specified, the API returns aggregated statistics for all queried domains.
start_time	string	Yes	Specifies the start time of the query range. Examples: 2020-06-01 10:00, 2020-06-01 If only a date is provided (2020-06-01), the start time is automatically set to 2020-06-01 00:00:00. The returned data includes records greater than or equal to the specified start time. Based on the selected aggregation interval, the time will be rounded down to the nearest interval. Example: When querying 2020-06-01 10:03 with a 5-minute interval, the first returned data point corresponds to 2020-06-01 10:00. The interval between start_time and end_time must not exceed 31 days.
end_time	string	Yes	Specifies the end time of the query range. Examples: 2020-06-02 10:00, 2020-06-02 If only a date is provided (2020-06-02), the end time is automatically set to 2020-06-02 23:59:59. The returned data includes records less than or equal to the specified end time. Based on the selected aggregation interval, the time will be rounded down to the nearest interval. Example: When querying 2020-06-02 10:17 with a 5-minute interval, the last returned data point corresponds to 2020-06-02 10:15:00. The interval between start_time and end_time must not exceed 31 days.
grad	string	No	Specifies the data aggregation interval. Supported values: [minute, minute5, hour, day] - minute: 1-minute interval - minute5: 5-minute interval - hour: Hourly interval - day: Daily interval If omitted, the default value is minute5.

Request Example

# The request URL must be URL encoded.

curl -X GET "https://cdn.api.edgenext.com/v2/stat/httpcode?token=xxxx\
&domains=example.com,example2.com\
&start_time=2020-06-01%2012:16\
&end_time=2020-06-01%2012:35"

Response Example

JSON format

Successful Response

{
    "code": 0, // code is 0 when the response is successful.
    "data": [
        [
            1590984900, // Timestamp, sorted in ascending order.
            {
                "0": 2, // Number of requests with status code 0.
                "200": 860,
                "302": 72,
                "304": 1,
                "403": 1217
            }
        ],
        [
            1590985200,
            {
                "200": 252,
                "301": 4,
                "302": 66,
                "304": 33,
                "403": 10,
                "404": 3
            }
        ],
        [
            1590985500,
            {
                "0": 25,
                "200": 608,
                "302": 85,
                "304": 80,
                "404": 4
            }
        ],
        [
            1590985800,
            {
                "0": 2,
                "200": 693,
                "302": 111,
                "304": 2,
                "404": 69
            }
        ],
        [
            1590986100,
            {
                "0": 2,
                "200": 762,
                "301": 4,
                "302": 133,
                "304": 90,
                "404": 113
            }
        ]
    ]
}

Error Response

{
    "code": 400101,
    "message": "domain(life.com) is invalid"
}

Response Headers

Example:

HTTP/1.0 200 OK

Api-Id:                14426827
Content-Type:          application/json; charset=utf-8
X-Ratelimit-Grad:      minute  // Rate limit granularity (minute/hour/day).
X-Ratelimit-Limit:     150     // Maximum number of requests allowed within the current rate limit period.
X-Ratelimit-Remaining: 10      // Remaining number of requests available within the current rate limit period.
X-Retry-After:         20      // Number of seconds until the current rate limit period is reset.

HTTP Status Code Description

HTTP Status Code	Description
404	The requested URL is invalid.
401	Authentication failed. The token is invalid or the API permission has not been enabled.
400	Invalid request parameters.
200	Request completed successfully and the requested data is returned.
5xx	Server-side error. Please contact the on-call support team.