Development Document

Per-Domain Edge Request Counts Download PDF Document

Endpoint

Request URL: stat/request/eachDomain (GET)

Endpoint Domain Name: cdn.api.baishan.com
Endpoint Version: v2

Endpoint Description

Looking up Per-domain request numbers.

Notice: The default data statistical granularity is 5 minutes. See the Response Header section for information on call frequency limit.

API Parameters

Notice: Please request the API token from your account team.

Request Parameters (GET)

Add request parameters to the URL query strings, i.e. ?key1=value1&key2=value2.

ParameterData TypeRequirementDescription
domainsstringRequiredDomain names. Separate domain names by a comma (,). Up to 10 domain names at a time. all means all domains names, For example, aa.qingcdn.com,bb.qingcdn.com
start_timestringRequiredStart time in the format of YYYY-mm-dd or YYYY- mm-dd HH:ii. For example, 2017-04-26 retrieves bandwidth/traffic data starting at 2017-04-26 00:00.
end_timestringRequiredEnd time in the format of YYYY-mm-dd or YYYY- mm-dd HH:ii. For example, 2017-04-26 retrieves bandwidth/traffic data ending at 2017-04-26 23:59. The end time has to be greater than start time but must be within the range of 31 days.
gradstringNot RequiredGranularity of the data. minute5 by default. The options are minute5 (5 minutes), hour, or day. When choosing minute5, the start time to end time range can not exceed 10 days.
stat_is_forwardstringNot Required0 (default): pointing backward, for example, 2016- 03-16 10:00 means [2016-03-16 10:00, 2016-03- 16 10:04]. 1: pointing forward, for example, 2016-03-16 10:05 means [2016-03-16 10:00, 2016-03-16 10:04].

Sample Request:

curl -X GET
"https://cdn.api.baishan.com/v2/stat/request/eachDomain?token=xxx&domains=aa.qingcdn.com,bb.qingcdn.com&start_time=2017-07-19&end_time=2017-07-19"

Sample Response

Json format.

{
    "code": 0, //code is success
    "data": {
        "aa.qingcdn.com": {
            "domain": "aa.qingcdn.com",
            "data": [
                [
                    1500393600,//Time stamp, minute5 granularity
                    15383//Request numbers
                ],
                [
                    1500393900,
                    17570
                ],
                ...
            ]
        },
        "bb.qingcdn.com": {
            "domain": "bb.qingcdn.com",
            "data": [
                [
                    1500393600,
                    15383
                ],
                [
                    1500393900,
                    17570
                ],
                ...
            ]
        }
        ...
    }
}

Response Header

HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8 
X-Ratelimit-Remaining:100 //100 calls left for the current minute 
X-Ratelimit-Limit:100 //requests (calls) per minutes maximum 
X-Ratelimit-Grad: minute //Unit of the request number limit
X-Retry-After:59 //the rate limit resets in 59 seconds 
Api-Id: 131277040

HTTP Status Codes

Error CodeDescription
404Bad request URLs.
401Authorization Error: Invalid token or lack of access.
400Bad request parameters.
200Success.
5xxPlease contact your account team.
CopyRight © 2015-2022 BaishanCloud . All Rights Reserved.