Documentation API Docs Bandwidth Report QueryDynamicStaticRequests

QueryDynamicStaticRequests

Update time: 2026-09-04 15:52:28

Applicable Products

Media Acceleration Live Broadcast,Content Acceleration,Dynamic Web Acceleration

API Description

This API is used to query the number of dynamic and static requests under different protocols for a customer. Users can specify parameters such as date range, aggregation granularity, region, and acceleration type for the query. The API will return the request count data aggregated according to the specified dimensions.

Call frequency

Single user trigger frequency: 60/5min

Request parameter(s)

Body Params

NameDescription
custString
The English name (cust_en_name) of a sub-client. When a merged account needs to view a sub-client's information, this parameter is required.
dateString
Specifies the query date. The date format is yyyy-mm-dd. If not provided or empty, it defaults to the current day.
startdateString
The start date for the query. Format: yyyy-mm-dd. This parameter must be used with 'enddate'. If the 'date' parameter is also provided, this parameter will be ignored.
enddateString
The end date for the query. Format: yyyy-mm-dd. This parameter must be used with 'startdate'. If the 'date' parameter is also provided, this parameter will be ignored.
channelString
The channels (domains) to be queried. If multiple channels are specified, use a semicolon (';') as a separator. If not provided or empty, it defaults to all channels for the queried customer.
regionString
The abbreviation for the acceleration region(s). If multiple regions are specified, use a semicolon (';') as a separator (e.g., 'region=cn;apac' to query data for CN and APAC regions). If not provided or empty, it defaults to all regions. Parameter Values
accetypeString
The acceleration type parameter (e.g., accetype=web). If multiple types are specified, use a semicolon (';') as a separator. If not provided or set to 'all', it represents all types.
dataTypeString
Type of requests. - 0: Number of HTTPS requests - 1: Number of dynamic HTTPS requests - 2: Number of HTTP requests - 3: Number of dynamic HTTP requests - 4: Number of static HTTPS requests - 5: Number of static HTTP requests - 6: Total number of requests
returnTypeString
Whether to aggregate in a specific way. Format: number_day|hour. For example, '2_day' means aggregation by every 2 days. If not specified, data will be returned in its original granularity (5_min) by default.
dataformatString
The response format. 1. optional values:xml, json. 2. 'xml' as default.
timezoneString
The GMT time zone. The parameter format is GMT+09:00 for the East Ninth Zone and GMT-09:00 for the West Ninth Zone. If not provided, it defaults to the local time zone (GMT+08:00, East Eighth Zone).

Response parameter(s)

Body Params

NameDescription
providerObject
Result data from the provider.
nameString
Tenant name.
typeString
The business type of the interface.
dateObject
Contains detailed time-series data for the queried period.
startdateString
Start date.
enddateString
End date.
channelObject
Contains detailed request count, grouped by channel.
nameString
Channel
hitObject
Number of requests
timeString
Time for the data point.
textString
Value of request number.

Error code

Error code(code)Description(message)HTTP statusSemantic
403invalid region/invalid channel/no channel/date range exceeds limit403invalid region/invalid channel/no channel/date range exceeds limit
500internal error500internal error

Example

JSON
JSON
Request example
Copy Copy success
#!/bin/bash
username="example_username"
apiKey="example_apikey"
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.atomile.com/myview/dyHit" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml" \
-d "channel=test.com&startdate=2026-01-01&enddate=2026-01-01&dataType=6"
Response example
Copy Copy success
{
    "provider": {
        "name": "WS",
        "type": "hit",
        "date": {
            "startdate": "2026-01-01",
            "enddate": "2026-01-01",
            "channel": {
                "name": "test.com",
                "hit": [
                    {
                        "time": "2025-09-30 00:05:00",
                        "text": "0"
                    },
                    {
                        "time": "2025-09-30 00:10:00",
                        "text": "0"
                    },
                    ...
                ]
            }
        }
    }
}