Get Bandwidth Usage
This API is used to get bandwidth billing usage data with 5 minutes data sample.
Note: This API will only return the bandwidth usage data of the logs that are 48 hours earlier than current time.
1. Request Definition
- API URL
https://cdn-api.swiftfederation.com/v1.0/usage/bandwidth
- Request Method
POST
- Request Header
Refer to HTTP Request Headers
- Request Body
Request Body Data Format: JSON
| Field | Required | Type | Description |
|---|---|---|---|
| domains | Mandatory | string[] | Array of domain names. |
| startTime | Mandatory | string | Start time. Format yyyy-MM-ddTHH:mm:ssZ UTC time. |
| endTime | Mandatory | string | End time. Format yyyy-MM-ddTHH:mm:ssZ UTC time. Interval between start time and end time cannot be longer than 24 hours. |
| fillFixedTime | Optional | boolean | Boolean value if need to fill in zero value for empty data. Values: true or false. Default value: false. |
- Request Body Example
{
"domains": [
"www.example1.com",
"www.example2.com"
],
"startTime": "2018-03-29T17:35:00Z",
"endTime": "2018-03-29T17:45:00Z",
"fillFixedTime": false
}
2. Response Definition
- Response Header
Refer to HTTP Response Headers
- Response Body
| Field | Type | Description |
|---|---|---|
| domain | string | Name of domain. |
| bandwidths | Bandwidth | List of bandwidth data with 5 minutes interval. |
| Bandwidth Definition | ||
| timestamp | string | Format yyyy-MM-ddTHH:mm:ssZ UTC time. E.g. 2018-03-29T17:35:00Z will return data from 2018-03-29T17:35:00Z to 2018-03-29T17:39:59Z. |
| value | float | Bandwidth value, format will be like 94.33. Unit is bps. |
- Response Body Example
[
{
"domain": "www.example1.com",
"bandwidths": [
{
"timestamp": "2018-03-29T17:35:00Z",
"value": 1.01
},
{
"timestamp": "2018-03-29T17:40:00Z",
"value": 3.01
}
]
},
{
"domain": "www.example2.com",
"bandwidths": [
{
"timestamp": "2018-03-29T17:35:00Z",
"value": 4.04
},
{
"timestamp": "2018-03-29T17:40:00Z",
"value": 7.04
}
]
}
]