QueryTrafficForMultiDomain
Update time: 2026-07-13 15:50:06
Applicable Products
universal
API Description
This interface is used to query the traffic summary of multiple domain names in the dynamic acceleration service. Users need to provide the acceleration domain name and time range to obtain traffic statistics. The returned data includes detailed data on the traffic of each time slice and the total traffic. It helps users analyze the traffic usage of each domain name to better manage and monitor their network resources.
- API URL: https://api.atomile.com/api/report/domainflow/dwa
- Method: POST
- Data latency: 5~15min
Call frequency
Single user trigger frequency: 300/5min
Request parameter(s)
Body Params
| Name | Description |
|---|---|
*domainListObject | Domain list:Domain number limits can be adjusted depending on different accounts. The default value is 1000(if you want to adjust,please, contact technical support) |
*domainNameList | Domain |
*datefromString | Start time
1.The format is yyyy-MM-ddTHH:mm:ss+08:00;
2.And smaller than the current time and 'dateTo';
3.Period between 'dataFrom' and 'dateTo' cannot be longer than 31 days |
*datetoString | End time
1.The format is yyyy-MM-ddTHH:mm:ss+08:00;
2.Must be greater than 'dateFrom';
3.If it's greater than the current time, then the current time is assigned as the value |
*typeString | Data granularity
1.fiveminutes: five minutes, hourly: one hour, daily: one day;
2.If not specified, daily is set as the default value;
3.If fiveminutes is specified as the value, then data is returned in actual configured granularity when there is specific configuration to data collecting granularity for the customer. |
Response parameter(s)
Body Params
| Name | Description |
|---|---|
flowSummaryInteger | Total traffic. Keep two digits of decimals. Unit: MB |
flowDataList | flowData |
timestampString | Date:
1.When the data query granularity is fiveminutes, the format is yyyy-MM-dd HH:mm; the data value of every time slice represents the data value within the previous time granularity range. The first time slice of the day is yyyy-MM-dd 00:05 AM, and the last one is yyyy-MM-dd 24:00.
2.When the data query granularity is hourly, the format is yyyy-MM-dd HH; the data value of every time slice represents the data value within the previous time granularity range. The first time slice of the day is yyyy-MM-dd 00:01, and the last one is yyyy-MM-dd 24.
3.When the data query granularity is daily, the format is yyyy-MM-dd; the data value of every time slice represents the value of the daily data.Return the time slice contained in start time and the time slice contained in end time |
flowInteger | Traffic. Keep two digits of decimals. Unit: MB |
Error code
| Error code(code) | Description(message) | HTTP status | Semantic |
|---|---|---|---|
| InvalidDatePeriod | datafrom or dateto not compliant to specifications | 400 | datafrom or dateto not compliant to specifications |
| DateSpanError | Period between datafrom and dateto is longer than 31 days | 400 | Period between datafrom and dateto is longer than 31 days |
| InvalidReportType | Parameter type not compliant to specifications | 400 | Parameter type not compliant to specifications |
| DomainNameIsRequired | Requrest body is specified and domain array is empty | 400 | Requrest body is specified and domain array is empty |
| NoSuchDomain | Domain does not exist, or does not belong to the current account that calls the interface | 404 | Domain does not exist, or does not belong to the current account that calls the interface |
| DomainsExcessive | Number of queried domains exceeds limits set to the account\n | 403 | Number of queried domains exceeds limits set to the account\n |
| ReportError | System encountered an error(an error returned from myview, and the error code is neither 200 nor 403) (no longer available, to be deleted) | 400 | System encountered an error(an error returned from myview, and the error code is neither 200 nor 403) (no longer available, to be deleted) |
| InternalError | System has encountered an error\n | 500 | System has encountered an error\n |
Example
JSON
- Request example Copy success
#!/bin/bash # Please remember to change the param (-H "X-Time-Zone") in this demo to the TimeZone you want in response 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/api/report/domainflow/dwa?datefrom=2017-11-07T00:00:00%2B00:00&dateto=2017-11-07T00:15:00%2B00:00&type=fiveminutes" \ -X "POST" \ -H "X-Time-Zone:GMT+00:00" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{ "domain-list":{ "domain-name":[ "www.example1.com", "www.example2.com" ] } }'- Response example Copy success
{ "flow-summary": "0", "flow-data": [ { "timestamp": "2019-04-09 00:05:00", "flow": "0" }, { "timestamp": "2019-04-09 00:10:00", "flow": "0" }, { "timestamp": "2019-04-09 00:15:00", "flow": "0" } ] }