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  
            }  
        ]  
    }  
]
           Updated 2019-06-06 05:52:21

results matching ""

    No results matching ""