Development Document

Per-Domain Origin Bandwidth and Traffic Download PDF Document

Endpoint

Request URL: stat/originBandwidth/eachDomain (GET)

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

Endpoint Description

Data of returning origin bandwidth/traffic volume, importing API parameters data_type=traffic to receive traffic volume data.

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.
data_typestringNot RequiredType of data to retrieve, such as traffic or bandwidth. The value is bandwidth by default.

Sample Request:

curl -X GET
"https://cdn.api.baishan.com/v2/stat/originBandwidth/eachDomain?token=xxx&start_time=2018-01-16&end_time=2018-01-16&domains=aa.qingcdn.com,bb.qingcdn.com"

Sample Response

Json format.

{
    {
    "code": 0,//code 0 means success
    "data": {
        "aa.qingcdn.com": {
            "domain": "aa.qingcdn.com",
            "data": []
        },
        "bb.qingcdn.com.com": {
            "domain": "bb.qingcdn.com",
            "data": [
                [
                    1515917400,//Time stamp, minute 5 granularity
                    214933321.12//Bandwidth value in bps
                ],
                [
                    1515904200,
                    207449380.64
                ],
                ...
            ]
        }
    }
}

Response Header

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

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.